원문: 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만 외부 서비스로 붙는다.

비슷한 도구와 비교

관련 노트