Javis603/token-monitor

Local-first desktop widget for tracking token usage, costs, and limits across 36+ AI coding tools—including Claude Code, Codex, Cursor, OpenCode, and OpenClaw—with multi-device sync.

Token Monitor – 무엇입니까

Token Monitor는 수십 가지 AI 기반 코딩 어시스턴트(Claude Code, GitHub Copilot, Cursor 등)의 토큰 소비량과 할당량 제한을 감시하는 크로스플랫폼 데스크톱 위젯입니다. 각 도구의 로컬 로그 또는 API 키 잔고를 읽어 데이터를 집계하고, 사용자 정의 가능한 대시보드에서 실시간 수치를 표시합니다. 이 앱은 여러 기기 간에 요약 정보를 동기화할 수 있어 항상 하나의 최신 상태를 확인할 수 있습니다.

핵심 기능 (README에 설명됨)

기능	작동 방식	표시 내용
실시간 토큰 추적	35개 이상의 지원 도구의 로컬 트랜스크립트 파일, SQLite 데이터베이스, 또는 API 키 잔고 엔드포인트를 읽습니다.	AI의 각 턴 이후 수초 내에 토큰 수가 업데이트됩니다.
세션별 분석	특정 세션(예: Claude Code 트랜스크립트)을 열고 프롬프트/응답 토큰 분할을 파싱합니다.	입력 토큰과 출력 토큰의 상세 정보, 캐시 히트/미스, 사용된 모델 확인 가능.
비용 표시	내장된 가격표(또는 수동으로 입력한 구독 정보)를 사용해 토큰을 USD, TWD, HKD, CNY로 변환합니다.	토큰 수와 금액이 옆으로 표시되며, 환율은 매일 갱신됩니다.
할당량/제한 모니터링	로컬 내보내기 또는 API 키 엔드포인트(OpenRouter, Minimax 등)에서 제공업체별 제한(일일, 주간, 청구 주기)을 쿼리합니다.	시각적 할당량 바, 비율 표시, 제한에 가까워지면 알림 제공.
역사적 추세 및 히트맵	일일 집계를 로컬에 저장(소스 파일 삭제 후 아카이브 가능).	1년치 히트맵, 스테이크 카운터, 도구 또는 모델별 스택형 막대/K선 차트.
다중 기기 동기화	기기의 사용 요약을 허브(위젯 내 호스팅, 자가 호스팅 Node, Cloudflare Worker)로 전송. 다른 기기는 Server-Sent Events로 업데이트를 수신.	모든 기기에서 동일한 실시간 수치 표시 가능. iOS 위젯도 동일한 허브에서 가져올 수 있음.
내보내기	필요 시 또는 스케줄에 따라 토큰 사용량을 CSV/JSON으로 기록.	스프레드시트, Grafana, Obsidian, 사용자 스크립트 등으로 쉽게 가져올 수 있음.
사용자 정의 UI	메뉴바(macOS) / 시스템 트레이(Windows) 팝오버, 플로팅 버블, macOS 네이티브 위젯 미리보기, 테마 및 투명도 컨트롤, 드래그 앤 드롭 레이아웃 컴포저.	작업 흐름에 맞는 외관 선택 가능. 단축키, Discord Rich Presence 추가 가능.

지원 도구 (요약)

Claude Code, Codex, OpenCode, Hermes Agent, OpenClaw, Cursor, Antigravity, Kimi, Qwen, Grok Build, GitHub Copilot, Pi, Zed, Kilo, Command Code, MiMo Code, ZCode, Kiro, CodeBuddy, WorkBuddy, Proma, Qoder CN, Reasonix, DeepSeek, Cherry Studio, LM Studio, Unsloth, OpenRouter, Minimax, Volcengine, Ollama, Trae CN, Alibaba Cloud, 그리고 New API 잔고 형식을 따르는 모든 제3자 API.

설치 및 첫 실행

macOS – brew install --cask token-monitor (Apple Silicon 또는 Intel dmg).
Windows – 서명된 .exe (설치 프로그램 또는 포터블).
Linux – AppImage (x64) 다운로드.
앱을 실행하면 자동으로 지원 도구를 감지하고 로컬 전용 모드로 사용량 추적을 시작합니다.

다중 기기 동기화 옵션

위젯 내 허브 호스팅 – 항상 켜진 기기를 하나 선택하고 생성된 LAN URL + 비밀번호를 다른 기기에 복사.
자체 호스팅 Node 허브 – TOKEN_MONITOR_SECRET 설정 후 헤드리스 서버에서 npm run hub 실행.
Cloudflare Worker 허브 – 1클릭 배포 버튼; 각 클라이언트에 워커 URL과 비밀번호 붙여넣기. 세 가지 모두 Server-Sent Events를 사용하므로 연결된 모든 위젯에 수초 내에 업데이트가 반영됩니다.

누가 이 도구를 유용하게 사용할 수 있을까?

여러 AI 코딩 어시스턴트를 사용하는 개발자 – 토큰 소비와 할당량 고갈을 추적하고 싶은 경우.
AI 서비스 예산을 공유하는 팀 – 투명하고 프라이버시 우선의 소비 현황을 원하는 경우.
프리랜서나 취미로 AI를 사용하는 사람 – 실시간 비용을 확인해 예기치 않은 청구를 피하고 싶은 경우.
여러 컴퓨터(데스크탑, 노트북, WSL, iPhone)에서 작업하는 사람 – 각 기기별 모니터링이 아니라 하나의 대시보드로 통합 관리하고 싶은 경우.

개인정보 보호 안내

모든 프롬프트/응답 내용은 로컬 기기에만 보관됩니다. 동기화 허브로 전송되는 것은 집계된 토큰 수, 비용, 제한 데이터뿐입니다. 허브는 자체 호스팅, 위젯 내 실행, 또는 Cloudflare에 배포 가능하여 데이터가 어디로 이동하는지 완전히 제어할 수 있습니다.

빠른 시작 체크리스트

OS에 맞는 앱 설치.
Token Monitor 열기 – 자동으로 지원 도구를 감지하고 실시간 사용량을 표시 시작.
(선택 사항) 여러 기기가 있다면 동기화 허브 설정.
대시보드 레이아웃, 통화, 내보내기 설정을 작업 흐름에 맞게 맞춤 설정.
모든 AI 코딩 도구에서 토큰 소비와 할당량 상태를 실시간으로 확인하세요.