Javis603/token-monitor

요약: Token Monitor는 Claude Code, Codex, Cursor, GitHub Copilot 등 46개 이상의 AI 코딩 도구의 로컬 로그와 데이터베이스를 모니터링하여 실시간 토큰 사용량, 캐시 적중 통계, 제공업체별 계정 한도(예: Codex 세션 상한 또는 타사 API 잔액)를 하나의 통합 인터페이스로 표시하는 데스크톱 위젯입니다.

주요 기능:

• 실시간 토큰 추적 및 실시간 '소모율' 표시(tok/s, tok/min)
• 세션별 상세 분석(프롬프트당 토큰, 사용된 도구) 및 도구/모델별 캐시 적중 vs. 실패 통계
• 제공업체별 요율 제한 및 청구 감지(29개 이상 제공업체) 및 다중 계정 지원(활성 Codex 계정의 원클릭 전환 포함)
• 연간 활동 히트맵, 연속 기록, 도구/모델별 추세 차트(막대 및 K-라인 보기)가 포함된 사용량 대시보드
• 도구가 자체 기록을 정리하더라도 데이터가 유지되도록 로컬 보관
• 다중 장치 동기화: 장치는 사용량 요약을 허브(Server-Sent Events)로 보내거나 iCloud Drive를 통해 거의 실시간으로 동기화
• CSV/JSON 내보내기, WSL 사용량 감지, 통화 표시 옵션(USD, TWD, HKD, CNY)

작동 방식: 각 장치는 자신의 로컬 파일 시스템 아티팩트(예: ~/.claude/projects/, ~/.codex/, VS Code globalStorage, SQLite DB)를 감시하여 토큰 수, 세션, 모델을 추출합니다. 계정 한도의 경우 API 키, 쿠키 또는 사용자 정의 잔액 엔드포인트(예: OpenRouter API 키, Alibaba Cloud 콘솔 쿠키)를 활용합니다. 이 원시 데이터를 로컬에서 메트릭으로 파싱한 다음 허브에 요약 업데이트를 중계합니다. 세션별 세부 정보는 온디맨드로 로컬 기록에서 읽히며 동기화되지 않습니다.

주목할 만한 세부 사항:

• 도구 데이터를 찾기 위한 사용자 정의 스캔 경로 및 환경 변수 재정의 지원(예: $CODEX_HOME, $XDG_DATA_HOME)
• 단일 장치 사용에는 서버가 필요 없지만 다중 장치 설정을 위한 자체 호스팅 동기화 백엔드를 제공
• Windows 10+, macOS 12+, Linux(x64)에서 작동하며 MIT 라이선스입니다