v2.0.0

QuotaBar

Claude, Codex, Gemini 같은 서비스의 사용량 한도를 메뉴막대에서 확인하는 macOS 앱입니다. iPhone에서는 위젯으로 볼 수 있습니다.

macOS 14 이상토큰은 키체인에만 저장

2.0 변경점

iPhone 앱과 위젯. 홈 화면과 잠금 화면 위젯을 쓸 수 있고, 당겨서 새로고침하거나 데모 모드로 체험해 볼 수 있습니다.
조회 방식 정리. Claude 추가 윈도우와 Codex 플랜을 읽고, Cursor와 Copilot은 로그인 상태를 자동으로 찾습니다. Gemini는 서버 잔량을 먼저 조회합니다.
화면과 아이콘. 링 게이지와 요약 화면을 새로 만들었고, 사용률에 따라 색이 초록, 노랑, 주황, 빨강으로 바뀝니다.

서비스마다 계정을 여러 개 연결할 수 있고, 개인용·회사용처럼 이름을 붙여 구분합니다. 메뉴막대에는 사용률이 가장 높은 항목이 표시됩니다.

Mac이 조회한 사용률만 iCloud를 거쳐 iPhone으로 전달됩니다. 별도 서버나 로그인은 필요 없고, 토큰은 iPhone으로 보내지 않습니다.

iPhone에서 당겨서 새로고침하면 Mac에 갱신을 요청합니다. Mac이 꺼져 있으면 마지막 값이 ‘오래됨’으로 표시됩니다. iPhone 앱은 App Store로 배포합니다.

macOS 앱은 Mac App Store가 아니라 직접 배포합니다. 샌드박스 안에서는 ~/.claude, ~/.codex를 읽거나 키체인을 조회할 수 없기 때문입니다.

# 소스에서 빌드 (macOS 14+, Xcode 15+)
git clone https://github.com/hoony6134/quotabar
cd quotabar
./scripts/build-app.sh
open build/QuotaBar.app

Claude, Codex, Cursor, Copilot 연동은 공식 API가 아닌 엔드포인트를 쓰기 때문에 예고 없이 동작하지 않을 수 있습니다. 문제가 생기면 해당 계정 카드에 오류가 표시됩니다.
Gemini와 Antigravity는 계정에 따라 로컬 기록으로 사용량을 추정하며, 실제 한도와 다를 수 있습니다.
조회 간격은 기본 5분입니다. 너무 짧게 줄이지 않는 편이 좋습니다.