TL;DR

CodexBar는 macOS 메뉴바에서 최대 57개 코딩 AI 공급자의 사용량, 크레딧, 비용 요약과 세션·주간·월간 리셋 카운트다운을 통합해 제공하는 경량 앱이다. 애플리케이션은 OAuth, 디바이스 플로우, API 키, 브라우저 쿠키, 로컬 CLI 설정 등 다양한 인증 소스를 재사용해 공급자별 데이터를 로컬에서 파싱하고 이를 사용률 바와 리셋 카운트다운으로 렌더링한다. 메뉴바 아이콘 기반의 빠른 확인과 병합 모드, 번들된 CLI를 통한 자동화가 가능한 대신 브라우저 쿠키 복호화나 Keychain 접근을 위해 사용자의 권한 부여가 필요하며 해당 권한 관리는 macOS Keychain ACL 설정을 통해 제어할 수 있다.

주요 기능

• 메뉴바에 각 공급자별 사용률 바와 세션·주간·월간 리셋 카운트다운을 표시한다.
• OAuth·디바이스 플로우·API 키·브라우저 쿠키·로컬 구성 파일 등 다양한 인증 소스를 재사용해 공급자별 세션을 수집한다.
• 공급자 상태 폴링으로 장애나 인시던트 배지를 아이콘 오버레이와 메뉴에 반영한다.
• 병합 모드에서는 여러 공급자를 하나의 상태 아이템으로 묶고 내부 전환 스위처를 제공한다.
• 번들된 CLI를 통해 설정을 스크립트화하거나 Linux 환경에서도 사용량 조회와 비용 명령을 실행할 수 있다.

어떻게 동작하는가

CodexBar는 각 공급자가 노출한 공개 API, 관리 콘솔, 브라우저 세션, 로컬 CLI 또는 설정 파일에서 인증 토큰과 사용량 데이터를 수집한다. 수집된 원천별 데이터를 공급자별 규칙으로 파싱해 세션·주간·월간 윈도우와 남은 크레딧을 계산하고 이를 메뉴바 UI의 사용률 바와 리셋 카운트다운으로 렌더링한다. 상태 폴링과 오류 플래그가 병행되어 인시던트를 아이콘 오버레이에 반영하며 사용자가 허용한 경우 로컬에서 쿠키 복호화와 Keychain 항목 접근을 수행한다.

해결 문제

CodexBar는 여러 코딩 AI 공급자의 서로 다른 사용량 창과 리셋 시점을 확인하기 위해 대시보드를 일일이 열어 확인해야 하는 번거로움을 제거한다. 이 도구는 공급자별 세션·주간·월간 윈도우를 표준화된 UI로 집계하고 카운트다운을 제공하므로 사용자가 작업 시작 시점과 예산을 계획하기 쉬워진다. 또한 CLI와 스크립트 통합을 통해 자동화된 설정과 배치 조회가 가능하므로 수동 모니터링 비용을 줄인다.

지금 주목받는 이유

공급자별 사용량과 리셋 윈도우가 확산되며 개발자들이 복수의 코딩 AI를 병행 사용하게 된 상황에서 단일 뷰로 소비와 리셋 타이밍을 확인하는 수요가 증가했다. CodexBar는 대시보드 접근 없이 메뉴바에서 실시간 카운트다운과 비용 스냅샷을 제공하므로 사용성 측면에서 주목을 받았다. 또한 Homebrew, AUR, Linux CLI 등 다양한 배포 채널을 통해 빠르게 채택 경로를 확장했다.

차별점

• 로컬 우선 방식으로 동작해 민감 정보의 중앙 서버 전송 없이 브라우저 쿠키, CLI 토큰, 로컬 설정 파일을 재사용한다. 이 방식은 계정 비밀번호를 저장하지 않고도 필요한 정보를 확보하도록 설계되어 프라이버시 노출을 최소화한다. 또한 macOS Keychain ACL과 연동해 사용자가 세밀하게 접근 권한을 제어할 수 있다.
• 다수 공급자에 대한 단일 메뉴바 아이템과 병합 모드를 제공해 데스크톱 공간을 적게 차지하면서도 개별 공급자의 상세 사용량을 접근 가능하게 한다. 개별 상태 아이템 대신 Merge Icons 모드를 사용하면 빠른 전환으로 다중 계정을 관리할 수 있다. 이 디자인은 여러 공급자를 동시에 사용하는 개발 환경에서 UI 복잡도를 낮추는 효과가 있다.
• 번들된 CLI와 Linux용 빌드, GNOME/Waybar 통합을 제공해 macOS 전용 앱이면서도 서버나 리눅스 데스크톱 환경에서 사용량 수집과 표시가 가능하다. CLI는 설정 파일 조작과 API 키 주입을 스크립트화하므로 CI나 원격 모니터링 파이프라인과도 결합된다. 이로 인해 GUI 없이도 자동화된 감시가 필요한 상황에 대응할 수 있다.

사용 사례

• 장시간 토큰 소모 작업을 시작하기 전에 각 공급자의 세션·주간·월간 리셋 시점을 비교해 작업 스케줄을 조정하는 용도로 사용된다.
• 여러 공급자의 비용·크레딧 소비를 정기적으로 모니터링하고 이상 지출이 발생했을 때 빠르게 원인을 추적하는 비용 감시 대시보드 보조 도구로 활용된다.
• CI나 원격 서버에서 CLI를 통해 정기적으로 사용량 스냅샷을 수집해 내부 모니터링 시스템과 연동하거나 Slack 등으로 알림을 발송하는 자동화 파이프라인에 통합된다.

시작하기

Homebrew Cask로 설치하거나 GitHub Releases에서 macOS 빌드를 내려받아 실행하면 메뉴바에 상태 아이템이 생성된다. 첫 실행 후 Settings → Providers에서 사용 중인 공급자를 활성화하고 OAuth 또는 API 키, 브라우저 쿠키 등 필요한 인증 소스를 설정하면 즉시 사용량 집계가 시작된다. 추가로 CLI를 설치하면 스크립트로 공급자 활성화·API 키 설정·사용량 조회를 자동화할 수 있다.

요구사항

• macOS 14 이상(앱 실행 및 메뉴바 통합이 macOS 14+용으로 빌드되어 있음)
• Swift 6.2 이상이 필요하며 소스에서 빌드할 경우 Xcode가 요구된다
• Linux에서는 번들된 CLI만 지원되며 GUI 통합은 각 데스크톱 확장(예: Waybar, GNOME 확장)을 통해 이루어져야 한다

이미지 분석