akitaonrails/ai-usagebar

해결하는 문제

ai-usagebar는 데스크톱 환경에서 여러 제공업체(Claude, ChatGPT/Codex, OpenRouter, DeepSeek 등)의 AI 서비스 할당량과 플랜 사용량을 직접 모니터링하고 계획할 수 있는 중앙 집중식 방법을 제공합니다. 남은 크레딧이나 초기화 타이머를 확인하기 위해 개별 제공업체의 대시보드를 수동으로 확인할 필요가 없습니다.

작동 방식

이 도구는 Rust로 작성되었으며 OAuth 자격 증명(공식 CLI에서 재사용) 또는 API 키를 사용하여 다양한 AI 제공업체로부터 사용량 데이터를 가져옵니다. 이 데이터는 다음과 같은 여러 인터페이스를 통해 제공됩니다:

• CLI/TUI: 독립형 터미널 사용자 인터페이스(ai-usagebar-tui) 및 스크립팅을 위한 JSON 출력 CLI.
• 데스크톱 위젯: Waybar (Wayland), Omarchy Quattro, GNOME Shell, KDE Plasma 6 및 macOS 메뉴 바를 위한 네이티브 통합.
• 캐싱: 여러 위젯이 활성화되어 있을 때 중복된 API 요청을 방지하기 위해 원자적 캐시(atomic caches)와 파일 잠금(file locking)을 사용합니다.

대상 사용자

여러 AI 코딩 서비스를 이용하며 시스템 트레이나 상태 표시줄에서 구독 제한 및 API 잔액을 마찰 없이 실시간으로 확인하고자 하는 개발자와 파워 유저.

주요 특징

• 광범위한 제공업체 지원: Claude, Codex, Z.AI, OpenRouter, DeepSeek, Kimi, Nous Research 등을 통합합니다.
• 멀티 인터페이스 지원: Linux (Waybar, GNOME, KDE), macOS, Windows (TUI) 전반에서 작동합니다.
• 유연한 인증: OAuth 토큰 재사용, 환경 변수 및 설정 파일을 지원합니다.
• 계정 관리: 동일한 제공업체에 대해 여러 개의 이름이 지정된 계정(예: 업무용 및 개인용 계정 분리)을 처리할 수 있습니다.
• 리소스 효율성: 문서화되지 않은 엔드포인트로부터의 공격적인 속도 제한(rate-limiting)을 피하기 위해 캐싱을 구현합니다.