ClaudeBar: AI 코딩 어시스턴트 사용량 쿼터 모니터링 macOS 메뉴 바 애플리케이션

AI 코딩 어시스턴트 (AI coding assistant) 사용량 쿼터 (quotas)를 모니터링하는 macOS 메뉴 바 애플리케이션입니다. Claude, Codex, Gemini, GitHub Copilot, Antigravity, Z.ai, Kimi, Kiro, Amp, OpenCode Go 등을 한눈에 추적하세요.

다크 모드 (Dark Mode) |
라이트 모드 (Light Mode) |
CLI 테마 (CLI Theme) |
크리스마스 테마 (Christmas Theme) |

멀티 프로바이더 지원 (Multi-Provider Support)

Claude, Codex, Gemini, GitHub Copilot, Antigravity, Z.ai, Kimi, Kiro, Amp, OpenCode Go 쿼터를 한 곳에서 모니터링
프로바이더 활성화/비활성화 (Provider Enable/Disable)
설정 (Settings)에서 개별 프로바이더를 켜거나 꺼서 모니터링을 맞춤 설정
실시간 쿼터 추적 (Real-Time Quota Tracking)
세션 (Session), 주간 (Weekly), 모델별 (Model-specific) 사용량 백분율 확인
다양한 테마 (Multiple Themes)
라이트 (Light), 다크 (Dark), CLI, 크리스마스 (Christmas), 그리고 가져온 터미널 테마 (.itermcolors)
자동 적응 (Automatic Adaptation)
시스템 테마는 macOS 외형을 따르며, 크리스마스 테마는 연휴 기간 동안 자동으로 활성화됨
시각적 상태 표시기 (Visual Status Indicators)
색상별로 구분된 진행 표시줄 (초록/노랑/빨강)로 쿼터 상태 표시
시스템 알림 (System Notifications)
쿼터 상태가 경고 (warning) 또는 심각 (critical) 단계로 변경될 때 알림 수신
자동 새로고침 (Auto-Refresh)
설정 가능한 간격으로 쿼터를 자동으로 업데이트
키보드 단축키 (Keyboard Shortcuts)
⌘D (대시보드 (Dashboard)) 및 ⌘R (새로고침 (Refresh))로 빠른 액세스

남은 양 (Remaining)	상태 (Status)	색상 (Color)
> 50%	정상 (Healthy)	초록 (Green)
...

macOS 15+
Swift 6.2+
모니터링하려는 프로바이더를 위한 CLI 도구 설치 필요:
Claude CLI (claude)
Codex CLI (codex)
Gemini CLI (gemini)
GitHub Copilot - 설정 (Settings)에서 인증 정보 (credentials) 구성
Antigravity - 로컬에서 실행 시 자동 감지
Z.ai - GLM Coding Plan 엔드포인트로 Claude Code 구성
Kimi (kimi) - CLI 모드 (권장) 또는 API 모드 (아래 참조)
Kiro (kiro-cli) - kiro-cli 설치 필요 (아래 참조)
Amp (amp) - CLI 설치 시 자동 감지
OpenCode Go (opencode) - 로컬 SQLite DB를 통해 OpenCode Go 사용 윈도우 (5시간/$12, 주간/$30, 월간/$60) 추적
Claude CLI (

Kimi는 두 가지 프로브 모드 (probe modes)를 지원하며, **설정 (Settings) > Kimi 구성 (Kimi Configuration)**에서 구성할 수 있습니다:

CLI 모드 (권장) - 대화형 kimi CLI를 실행하고 /usage를 전송하여 쿼터 (quota) 데이터를 가져옵니다. kimi CLI가 설치되어 있어야 합니다 (uv tool install kimi-cli). 전체 디스크 접근 권한 (Full Disk Access)은 필요하지 않습니다.

API 모드 - 브라우저 쿠키 인증을 사용하여 Kimi API를 직접 호출합니다. ClaudeBar가 kimi-auth 브라우저 쿠키를 읽을 수 있도록 **전체 디스크 접근 권한 (Full Disk Access)**이 필요합니다:

시스템 설정 (System Settings) > 개인정보 보호 및 보안 (Privacy & Security) > **전체 디스크 접근 권한 (Full Disk Access)**을 엽니다. - ClaudeBar를 켭니다 (또는 +를 클릭하여 추가합니다). - ClaudeBar를 재시작합니다.

API 모드에서 쿠키 읽기를 건너뛰려면 KIMI_AUTH_TOKEN 환경 변수를 설정할 수도 있습니다.

Kiro는 kiro-cli 명령줄 도구를 통해 AWS Kiro (이전의 CodeWhisperer) 사용량을 모니터링합니다.

설치 (Installation): uv tool install kiro-cli 또는 pip install kiro-cli

인증 (Authentication): kiro-cli를 실행하고 로그인 안내를 따르세요.

Kiro IDE 사용자: Kiro IDE를 사용하는 경우, kiro-cli만 설치하면 됩니다. 두 도구는 동일한 인증을 공유하므로 추가 로그인이 필요하지 않습니다.

Homebrew를 통해 설치하세요.

brew install --cask claudebar

GitHub Releases에서 최신 릴리스를 다운로드하세요:

DMG: 파일을 열고 ClaudeBar.app을 응용 프로그램 (Applications) 폴더로 드래그합니다. ZIP: 압축을 풀고 ClaudeBar.app을 응용 프로그램 (Applications) 폴더로 이동합니다.

두 방식 모두 Gatekeeper를 위해 코드 서명 (code-signed) 및 공증 (notarized)되었습니다.

git clone https://github.com/tddworks/ClaudeBar.git
cd ClaudeBar
# Tuist 설치 (설치되지 않은 경우)
...

빌드 후, 생성된 Xcode 워크스페이스 (workspace)를 열고 앱을 실행하세요:

tuist generate
open ClaudeBar.xcworkspace

그 다음 Xcode에서 Cmd+R을 눌러 실행합니다. 앱이 메뉴 바 (menu bar)에 나타납니다. 클릭하여 각 제공업체(provider)의 쿼터 상세 정보를 확인할 수 있습니다.

이 프로젝트는 의존성 관리 (dependency management) 및 Xcode 프로젝트 생성을 위해 Tuist를 사용합니다.

# Tuist 설치 (설치되지 않은 경우)
brew install tuist
# 의존성 설치
...

# 프로젝트 빌드
tuist build
# 모든 테스트 실행
...

Xcode에서 연 후, Cmd+Option+Return을 누르면 SwiftUI 프리뷰 (previews)가 작동합니다. 이 프로젝트는 프리뷰 지원을 위해 ENABLE_DEBUG_DYLIB로 구성되어 있습니다.

전체 문서: docs/ARCHITECTURE.md

ClaudeBar는 QuotaMonitor를 단일 진실 공급원 (Single Source of Truth)으로 사용하는 **계층형 아키텍처 (layered architecture)**를 사용합니다:

계층 (Layer)	목적 (Purpose)
App	도메인을 직접 소비하는 SwiftUI 뷰 (ViewModel 없음)
Domain	풍부한 모델, `QuotaMonitor`, 리포지토리 프로토콜
Infrastructure	프로브 (Probes), 저장소 구현체, 어댑터

단일 진실 공급원 (Single Source of Truth)

QuotaMonitor가 모든 프로바이더 상태를 소유합니다.

리포지토리 패턴 (Repository Pattern)

설정 및 자격 증명이 주입 가능한 프로토콜 뒤로 추상화됩니다.

프로토콜 기반 의존성 주입 (Protocol-Based DI)

@Mockable 프로토콜을 통해 테스트 가능성을 확보합니다.

시카고 학파 TDD (Chicago School TDD)

테스트는 메서드 호출이 아닌 상태 변화를 검증합니다.

ViewModel/AppState 없음

뷰가 도메인을 직접 소비합니다.

ClaudeBar의 외관을 터미널과 일치시키세요. 어떤 .itermcolors 파일이든 가져올 수 있습니다:

Settings (톱니바퀴 아이콘) 열기 - Import .itermcolors 클릭 - 파일 선택 (iTerm2에서 내보내기: Preferences > Profiles > Colors > Color Presets > Export)

iTerm2-Color-Schemes에서 450개 이상의 사전 제작된 스킴을 사용할 수 있습니다.

가져온 테마는 ~/.claudebar/themes/에 저장되며 재시작 후에도 유지됩니다.

add-provider 스킬을 사용하여 TDD 방식으로 새로운 프로바이더를 추가하는 과정을 안내받으세요:

Claude Code에게 다음과 같이 말하세요: "I want to add a new provider for [ProviderName]"

이 스킬은 다음 과정을 안내합니다: 테스트 파싱 (Parsing Tests) → 프로브 테스트 (Probe Tests) → 구현 (Implementation) → 등록 (Registration).

자세한 내용은 .claude/skills/add-provider/SKILL.md를 참조하고, AntigravityUsageProbe를 참조 구현체로 활용하세요.

Sparkle - 자동 업데이트 프레임워크
Mockable - 테스트를 위한 프로토콜 모킹 (Protocol mocking)
Tuist - Xcode 프로젝트 생성 (SwiftUI 프리뷰용)

릴리스는 GitHub Actions를 통해 자동화됩니다. 버전 태그를 푸시하면 새로운 릴리스가 생성됩니다.

상세한 설정 지침은 docs/release/RELEASE_SETUP.md를 참조하세요.

워크플로우는 Tuist를 사용하여 Xcode 프로젝트를 생성합니다:

Tag v1.0.0 → Update Info.plist → tuist generate → xcodebuild → Sign & Notarize → GitHub Release

버전은 Sources/App/Info.plist에 설정되며 Sparkle 자동 업데이트로 이어집니다.

GitHub Secrets 설정(전체 가이드 참조):
Secret Description APPLE_CERTIFICATE_P12

Developer ID certificate (base64) APPLE_CERTIFICATE_PASSWORD

.p12용 비밀번호 APP_STORE_CONNECT_API_KEY_P8

API key (base64) APP_STORE_CONNECT_KEY_ID

Key ID APP_STORE_CONNECT_ISSUER_ID

Issuer ID

인증서 확인:
./scripts/verify-p12.sh /path/to/certificate.p12

릴리스(Release) 생성:
git tag v1.0.0 git push origin v1.0.0

워크플로(Workflow)가 자동으로 빌드(Build), 서명(Sign), 공증(Notarize)을 수행하고 GitHub Releases에 게시합니다.

ClaudeBar에 기여해주신 모든 분들께 감사드립니다!

MIT

ClaudeBar: AI 코딩 어시스턴트 사용량 쿼터 모니터링 macOS 메뉴 바 애플리케이션

요약

핵심 포인트

Issuer ID

댓글