steipete/CodexBar

CodexBar – macOS용 AI 코드 할당량 모니터 (Linux용 CLI 포함)

무엇인가요 – macOS 14 이상 전용 메뉴바 앱(내장된 명령줄 도구 포함)으로, 사용 중인 각 AI 코드 제공자(OpenAI, Claude, Gemini, Copilot, Grok 등)의 남은 토큰/크레딧 수를 실시간으로 표시합니다. 제공자의 사용 윈도우 리셋 시점(매일, 매주, 매월)도 표시하고, 지출/크레딧 잔액을 확인할 수 있습니다.

왜 사용해야 할까

예기치 않은 문제 회피 – 할당량 리셋까지의 카운트다운을 확인해 장시간 코드 생성 작업을 계획할 수 있습니다.
비용 인식 – API 사용량과 크레딧 잔액을 제공하는 제공자에 대해 인라인 차트로 시각화합니다.
실시간 상태 – 제공자 상태를 주기적으로 확인해 메뉴 아이콘에 사고 알림 배지를 표시합니다.
개인정보 우선 – 기존 세션(OAuth, API 키, 브라우저 쿠키)을 재사용하며 비밀번호를 저장하지 않습니다. 제공자를 활성화할 때만 알려진 몇 가지 파일만 읽습니다.

주요 기능 (README에 설명됨)

제공자별로 하나의 상태 항목, 또는 아이콘 병합 모드로 여러 아이콘을 하나의 아이콘으로 통합하고 전환 가능.
제공자별 사용량 메터와 리셋 카운트다운.
API 기반 제공자(OpenAI, Claude Admin API, OpenRouter, LiteLLM 등)용 비용/사용량 차트.
지속적인 사용 및 지출 보기에서 7일/30일 예측을 원화별로 그룹화.
사고 알림 배지를 포함한 제공자 상태 확인.
설정 가능한 갱신 간격(적응형 기본값, 고정 1분~30분 옵션).
스크립트 및 CI용 패키지된 CLI(codexbar): 예시 codexbar cost --provider openai.
지원되는 제공자용 WidgetKit 위젯.
21개 언어로 로컬라이즈된 UI 및 RTL 지원.
할당량 리셋 시 알림(옵션).
도크 아이콘 없음. 메뉴바에만 존재하는 최소한의 UI.

지원되는 제공자 – 60개 이상의 제공자를 내장 지원. OpenAI, Claude, Gemini, Azure OpenAI부터 ElevenLabs, Deepgram, Zed, JetBrains AI, AWS Bedrock, GroqCloud, LiteLLM 등 다양한 서비스까지. 새로운 제공자의 추가는 문서화된 제공자 작성 가이드를 통해 가능합니다.

설치 방법

macOS – GitHub 릴리스 페이지에서 릴리스를 다운로드하거나 Homebrew Cask로 설치:
```
brew install --cask codexbar
```
Linux – Homebrew(brew install steipete/tap/codexbar) 또는 Arch AUR(yay -S codexbar-cli)로 CLI 설치. 다양한 아키텍처용 타르볼도 제공.
초기 실행 – 설정 → 제공자를 열고 사용하는 서비스를 활성화합니다. 필요에 따라 API 키, OAuth 인증 정보, 또는 브라우저 쿠키를 제공합니다. API 키는 CLI에서 설정 가능:
```
printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin
```

권한 – 앱은 다음 권한을 요청할 수 있습니다:

전체 디스크 액세스 (선택 사항): 웹 기반 제공자용 Safari 쿠키를 읽기 위해.
키체인 액세스: Chromium 쿠키 복호화 또는 저장된 OAuth 토큰 읽기.
폴더/볼륨 액세스: 외부 제공자 CLI 실행 시. 모든 프롬프트는 README에 설명되어 있으며, 고급 설정에서 키체인 읽기 기능을 완전히 비활성화할 수 있습니다.

개발 – macOS 14+용 Swift 6.2+로 개발. 리포지토리에는 앱 패키징, 테스트 실행, 린트, 문서 생성 스크립트가 포함되어 있습니다. macOS 및 Linux용 CLI 바이너리도 함께 빌드됩니다.

관련 프로젝트 – 저자는 Trimmy(클립보드 실행 헬퍼), MCPorter(TypeScript 툴킷, Model Context Protocol용), oracle(GPT-5 스타일 쿼리 도구)도 유지 관리합니다. Windows, Wayland, COSMIC, GNOME, Cinnamon용 커뮤니티 포트도 존재합니다.

위 모든 정보는 리포지토리의 README에서 직접 가져왔으며, 추가 기능은 추측되지 않았습니다.