원문: soulduse/ai-token-monitor · 수집일: 2026-10-05 · 릴리스 v0.24.2(2026-10-01) · Stars 345 · MIT(README 기준) · Rust + React
한눈에 보기
“내 AI 코딩 도구가 실제로 얼마를 쓰고 있나”라는 질문 하나에 답하는 시스템 트레이 앱이다. 각 CLI가 이미 디스크에 남기는 세션 로그(JSONL·SQLite)를 읽고, 모델별 단가(캐시 읽기 포함)로 토큰마다 값을 매겨 오늘 쓴 비용을 메뉴바 시계 옆에 띄운다. 클릭하면 차트·한도 경고·리더보드가 있는 대시보드가 열린다.
- 설정이 필요 없다 — API 키도 프록시도 없다. Claude Code나 Codex를 한 번이라도 썼으면 바로 동작한다.
- 기본은 완전 오프라인 — 리더보드·채팅·웹훅을 켜지 않으면 네트워크 요청을 하지 않는다. 켜도 일별 토큰 수·비용·세션 수 같은 집계값만 보내고 코드·대화 내용은 보내지 않는다.
- 플랫폼 — macOS(Apple Silicon
.dmg, Intel은 예정), Windows 10+(.exe). Linux는 Tauri라 동작할 수도 있지만 미검증이다.
읽는 데이터
| 도구 | 경로 | 비고 |
|---|---|---|
| Claude Code | ~/.claude/projects/**/*.jsonl | 세션·도구 호출 수는 stats-cache.json. 여러 루트(업무·개인 계정) 합산 가능 |
| Codex | ~/.codex/sessions/**/*.jsonl | 여러 루트 지원 |
| OpenCode | ~/.local/share/opencode/**/*.jsonl | 내장 단가표 사용 |
| Gemini CLI | ~/.gemini/tmp/*/chats/ | 캐시 토큰은 프롬프트에서 분리, thoughts는 출력으로 과금. 기본 30일 뒤 채팅이 지워져 그 이전 기록도 사라짐 |
| Grok | ~/.grok/logs/unified.jsonl | 로그가 잘려 나가므로 일별로 로컬 스냅샷에 누적 |
| Kiro | ~/.kiro/sessions/cli/ + data.sqlite3 | 토큰이 아니라 크레딧만 기록 → 크레딧 × $0.04(초과 요금)로 환산 |
| Hermes Agent | ~/.hermes/state.db (+ 프로필별 DB) | 압축·비전·제목 생성 같은 보조 호출까지 포함, Hermes 자체 비용값 사용 |
| GJC·OmO·Pi | 각 에이전트의 세션 JSONL | 메시지별 사전 계산 비용, API 응답 id로 중복 제거 |
주요 기능
- 추적·시각화 — 7/30일 토큰·비용 막대 차트, GitHub식 활동 히트맵(2D/3D), 주·월 단위 이동, 모델별 입력·출력·캐시 비율, 캐시 적중률 도넛.
- 한도 경고 — Claude OAuth로 로그인하면 5시간 세션·주간 플랜 한도를 실시간 막대로 보여 주고, 임계치를 넘거나 리셋될 때 Discord·Slack·Telegram 웹훅을 보낸다.
- 소셜(옵트인) — GitHub OAuth 리더보드, 7일 TOP 10, README에 넣는 배지, 리더보드 회원 간 채팅(Supabase 사용, 본인 API 키로 AI 번역).
- 놀이 요소 — 월·연 결산 카드(AI Report), 영수증 형식 요약, 월 AI 지출을 연봉 대비 비율(라떼·넷플릭스·치킨 환산)로 보여 주는 비교기.
- 기타 — 테마 4종, 10개 언어(한국어 포함), 자동 업데이트, 로그인 시 자동 실행.
구조
Tauri v2(Rust) 백엔드가 notify로 로그 파일을 감시하다 바뀌면 중복을 제거하고 다시 집계한다. 트레이 비용 표시, 웹훅 발송, 로컬 암호화 비밀값 저장도 백엔드가 맡는다. 프런트엔드는 React 19 + Vite다. 리더보드·채팅을 위한 Supabase만 외부 서비스로 붙는다.
비슷한 도구와 비교
- 2026-04-15-codeburn-ai-coding-cost-dashboard — 같은 “디스크 세션 파일을 프록시 없이 읽는” 방식이지만, CodeBurn은 37~41개 도구를 다루고 작업별 분해·최적화 제안처럼 낭비 분석에 무게를 둔다. AI Token Monitor는 상시 표시와 한도 경고에 무게를 둔다.
- 2026-08-23-github-kenn-io-agentsview — 세션 전문 검색과 팀 동기화까지 하는 분석 도구. 비용 대시보드는 그 일부다.
- 2026-04-10-ccmonitor-claude-code-tui-dashboard — Claude Code 전용 터미널 TUI. 메뉴바 상주형이 아니다.
관련 노트
- moc-claude-code · codex · opencode · hermes-agent — 로그를 읽는 대상 도구
- moc-ai-coding-catalog
- 2026-10-05-github-soulduse-team-ai — 같은 개발자의 Claude Code·Codex 다중 계정 릴레이