akitaonrails/ai-usagebar

해결하는 문제

ai-usagebar는 다양한 AI 코딩 서비스 및 LLM 공급자(Claude, ChatGPT, GitHub Copilot, DeepSeek 등)의 사용량과 크레딧 잔액을 데스크톱 환경에서 직접 중앙 집중식으로 모니터링할 수 있는 방법을 제공합니다. 제한에 도달하기 전에 남은 크레딧이나 토큰을 확인하기 위해 여러 공급자의 대시보드를 수동으로 확인할 필요가 없습니다.

작동 방식

이 도구는 모니터링 계층으로 작동하여 다양한 공급자 API에서 사용 데이터를 가져오거나 공식 CLI가 생성한 로컬 인증 파일을 읽습니다. 데이터를 표시하기 위해 다음과 같은 여러 프런트엔드 통합을 제공합니다.

• 시스템 위젯: Omarchy Quattro용 네이티브 패널, Wayland용 Waybar 모듈, Windows용 시스템 트레이 팝오버.
• TUI: 공급자 개요를 간결하게 보여주는 탭 기반 터미널 사용자 인터페이스 (ai-usagebar-tui).
• 데스크톱 통합: GNOME Shell, KDE Plasma 6 및 macOS 지원.

원자적 캐시와 파일 잠금을 사용하여 중복된 네트워크 요청을 방지하며, 공급자에 의해 차단되는 것을 피하기 위해 속도 제한 로직(예: HTTP 429 오류 발생 후 5분 대기)을 구현했습니다.

대상 사용자

여러 AI 코딩 어시스턴트나 LLM API를 사용하며, 워크플로우를 중단하지 않고 남은 사용량, 재설정 타이머, 지출 상황을 실시간으로 한눈에 확인하고 싶은 개발자 및 파워 유저.

주요 특징

• 광범위한 공급자 지원: Claude, Codex, GitHub Copilot, Z.AI, OpenRouter, DeepSeek, DeepInfra, Kimi, Nous Research 등 다수의 서비스와 통합.
• 멀티 플랫폼: Linux (Nix, Arch 등), macOS 및 Windows에서 사용 가능.
• 유연한 표시: Waybar, Omarchy Quattro, TUI 및 Windows 시스템 트레이 지원.
• 스마트 알림: 사용량이 설정한 임계값(예: 97%)을 초과할 때 데스크톱 알림 전송.
• 자격 증명 재사용: 공식 CLI(claude, gh, codex 등)의 기존 OAuth 토큰을 활용하여 중복 로그인 방지.