프로젝트 소개

토큰 소비 대시보드는 AI Agent 사용자를 위한 로컬 사용량 분석 도구입니다. 로컬 세션 로그를 직접 읽어 WorkBuddy, Claude Code, Codex, Cursor, Gemini CLI 등 12종 로그 소스를 자동 감지하고, 요청 수, 입력/출력 토큰, 캐시 적중, 추론 토큰, 비용 추정을 집계하여 단일 파일 HTML 대시보드로 표시합니다. 도구는 완전히 오프라인으로 실행되며 어떤 네트워크 요청도 보내지 않고 데이터는 본 기기를 떠나지 않습니다. Python 표준 라이브러리에만 의존하고 추가 패키지를 pip로 설치할 필요가 없으며 Python 3.8 이상을 지원합니다. 실행 후 내장 로컬 HTTP 서비스가 시작되고 페이지는 15초마다 자동 새로고침되며, 공유나 보관용 정적 스냅샷을 생성할 수도 있습니다. 대시보드는 개요, 소스 비교, 모델 분포, 일별 추세, 세션 Top 20 등의 뷰를 포함하고 스크립트 통합을 위한 /api/data JSON 인터페이스를 제공합니다. 인터페이스는 매실 자주색과 산호 분홍 색상을 사용하며 반응형 레이아웃, 시스템을 따르는 다크 모드, prefers-reduced-motion에서의 애니메이션 저하를 지원합니다. 비용 추정은 공개 단가를 기반으로 하며 설정 파일을 통해 가격표를 덮어쓸 수 있습니다. 프로젝트 구조는 명확하여 새 Agent를 추가하려면 sources.py에 설정 한 줄만 추가하면 되고, 파서는 후보 키 이름과 재귀적 하향 탐색 전략을 사용하여 일반적인 토큰 필드 이름을 자동으로 인식합니다.