🐱 BurnRate

개발자가 사용하는 AI 코딩 에이전트의 크레딧·구독 소진율(Burn Rate) 을 macOS 메뉴바에서 한곳에 모아 보는 네이티브 상태바 앱입니다.

메뉴바 🔥 아이콘을 클릭하면 미니 대시보드가 열리고, 연동된 에이전트별 사용량과 상세 쿼터를 확인할 수 있습니다.

---

현재 지원 (v0.1.0)

에이전트	상태	연동 방식
Antigravity	✅ 지원	Antigravity CLI 세션 + Usage API
Cursor	✅ 지원	Cursor 로컬 세션 + Usage API
Claude Code	🚧 준비 중	—
Codex	🚧 준비 중	—
GitHub Copilot	📋 로드맵	—

---

설치

Homebrew (권장)

macOS 13+ 및 Homebrew가 필요합니다. Xcode 또는 Command Line Tools(Swift 빌드용)도 필요합니다.

brew tap kwaneung/burnrate https://github.com/kwaneung/burnrate
brew install burnrate
burnrate

실행 후 메뉴바 🔥 아이콘이 표시됩니다. Formula는 CLI 바이너리이므로 터미널에서 burnrate로 실행합니다.

업데이트:

brew update
brew upgrade burnrate

v1.0.0 예정: 서명된 .app Cask 배포로 Applications에서 실행·로그인 항목 등록이 가능해질 예정입니다.

---

사용 방법

앱 사용

1. 메뉴바 🔥 아이콘 클릭
2. 설정(⚙️) → Antigravity / Cursor 연동하기
3. 대시보드에서 서비스 선택 → 상세 사용량 확인
4. 대시보드 노출 설정에서 표시할 에이전트 on/off

설정 변경은 즉시 반영됩니다. 별도 저장 버튼은 없습니다.

---

연동 상세

Antigravity와 Cursor는 동일한 로컬 세션 읽기 → Usage API 폴링(15초) → 설정 화면 상태 메시지 패턴을 사용합니다. BurnRate가 직접 OAuth·Keychain 로그인을 하지 않으며, 각 도구에 미리 로그인되어 있어야 합니다.

Antigravity

Antigravity CLI(agy)에 Google 계정으로 로그인되어 있어야 합니다. BurnRate는 CLI가 저장한 로컬 OAuth 세션으로 Usage API를 조회합니다. access token은 refresh token으로 자동 갱신됩니다.

항목	내용
세션 파일	~/.gemini/antigravity-cli/antigravity-oauth-token
OAuth 자격 증명	설치된 agy 바이너리에서 런타임 추출 (또는 ANTIGRAVITY_CLIENT_ID / ANTIGRAVITY_CLIENT_SECRET 환경 변수)
Usage API	POST https://daily-cloudcode-pa.googleapis.com/v1internal:retrieveUserQuotaSummary (15초 폴링)
캐시 파일	~/.gemini/antigravity-cli/api_usage.json (그룹·버킷 쿼터 JSON 저장)
상세 화면	그룹별(Gemini / Claude·GPT) Weekly·5-Hour 잔여 %, 갱신 시각 (agy CLI TUI와 동일 형식)
세션 만료 시	설정에 agy를 실행해 다시 로그인해 주세요 안내
연동 해제	설정 → Antigravity → 연동 해제

참고: Usage API는 Antigravity CLI가 사용하는 비공식 Google 내부 엔드포인트입니다. agy CLI 업데이트에 따라 응답 형식이 바뀔 수 있습니다.

Cursor

Cursor 에디터에 로그인되어 있어야 합니다. 세션은 Cursor가 저장한 로컬 SQLite DB에서 읽고, 사용량은 Cursor 웹 API로 조회합니다. Keychain을 읽지 않으므로 Keychain 접근 팝업이 뜨지 않습니다. 토큰 갱신은 Cursor 앱이 담당합니다.

항목	내용
세션 파일	~/Library/Application Support/Cursor/User/globalStorage/state.vscdb
세션 키	cursorAuth/accessToken (JWT)
Usage API	GET https://cursor.com/api/usage-summary (15초 폴링)
상세 화면	Total / Auto+Composer / API 사용률, 플랜명(Pro, Pro+ 등)
세션 만료 시	설정에 Cursor를 실행해 다시 로그인해 주세요 안내
연동 해제	설정 → Cursor → 연동 해제

참고: Cursor Usage API는 비공식 엔드포인트입니다. Cursor 업데이트에 따라 동작이 바뀔 수 있습니다.

---

소스에서 빌드

Xcode 없이 터미널에서 실행할 수 있습니다.

git clone https://github.com/kwaneung/burnrate.git
cd burnrate
swift run

Release 빌드:

swift build -c release --disable-sandbox
.build/release/burnrate

---

아키텍처

graph TD
    A[MenuBarExtra 🔥] --> B[DashboardView]
    B --> C[SettingsView]
    B --> D[AntigravityDetailView]
    B --> E[CursorDetailView]

    F[ConfigManager] --> B

    F -->|15초 폴링| G["Antigravity retrieveUserQuotaSummary"]
    G --> G1[AntigravitySessionReader]
    G1 -->|refresh token| G2[OAuth token 갱신]

    F -->|15초 폴링| I["cursor.com/api/usage-summary"]
    I --> H[CursorSessionReader]
    H -->|SQLite| H1[state.vscdb JWT]

Loading

프로젝트 구조

burnrate/
├── Package.swift
├── Formula/
│   └── burnrate.rb                        # Homebrew Formula
├── README.md
└── Sources/BurnRate/
    ├── Controllers/BurnRateApp.swift      # @main, MenuBarExtra
    ├── Models/
    │   ├── ConfigManager.swift            # 상태·동기화 핵심
    │   ├── AntigravitySessionReader.swift # Antigravity CLI 세션 읽기
    │   ├── AntigravityQuotaClient.swift   # Antigravity Usage API
    │   ├── CursorSessionReader.swift      # Cursor JWT 세션 읽기·만료 검사
    │   ├── AIService.swift
    │   └── UsageData.swift                # AntigravityQuotaGroup / Bucket 모델
    ├── Views/
    │   ├── DashboardView.swift
    │   ├── SettingsView.swift
    │   ├── AntigravityDetailView.swift
    │   ├── CursorDetailView.swift
    │   └── ServiceRowView.swift
    └── Resources/Info.plist

---

기술 스택

• 언어 / UI: Swift 5.8+, SwiftUI
• 최소 OS: macOS 13+
• 빌드: Swift Package Manager (외부 의존성 없음)
• 백그라운드: LSUIElement (Dock 아이콘 없음)
• Info.plist: 링커 -sectcreate로 실행 파일에 내장

---

알려진 제한

• Cursor·Antigravity Usage API는 모두 비공식 엔드포인트입니다. 각 도구 업데이트에 따라 동작이 바뀔 수 있습니다.
• 세션이 만료되면 BurnRate가 설정 화면에 재로그인 안내를 표시하지만, 토큰 갱신은 각 도구(agy / Cursor)가 수행해야 합니다.
• Antigravity는 refresh token으로 access token을 자동 갱신합니다. Cursor는 JWT 만료·401 시 Cursor 앱 재실행이 필요할 수 있습니다.
• Claude Code, Codex, GitHub Copilot은 아직 연동되지 않았습니다.

---

로드맵

• Claude Code / Codex / GitHub Copilot 연동
• Homebrew Formula 배포 (brew install burnrate)
• Homebrew Cask 배포 (v1.0.0 — Developer ID 서명 .app + Notarization)
• 메뉴바 아이콘 Burn Rate 애니메이션

---

기여

Issue와 Pull Request를 환영합니다.