Tokemon: LLM 토큰 사용량을 추적하는 터미널 대시보드

섹션별 상세

여러 AI 도구에 흩어진 API 사용량 데이터를 로컬에서 통합한다. Claude Code, Cursor 및 개별 API 스크립트가 생성하는 로그 파일을 자동으로 찾아 분석하므로 각 서비스의 빌링 페이지를 일일이 방문할 필요가 없다.

로컬 로그 파싱 과정에서 데이터 중복 제거(Deduplication)를 수행한다. 동일한 요청이 여러 로그 파일에 중복 기록되어 비용이 과다하게 산출되는 현상을 방지하여 실제 청구될 금액에 가까운 정확한 통계를 제공한다.

Rust 언어를 기반으로 구축되어 높은 성능과 낮은 리소스 점유율을 보장한다. 대량의 로그 파일을 빠르게 처리하며, 백그라운드에서 실행 시 시스템 부하를 최소화하도록 설계됐다.

bash

tokemon top

실시간 TUI 대시보드를 실행하여 토큰 사용량 트렌드를 확인하는 명령어

TUI(Terminal User Interface) 기반의 라이브 대시보드 기능을 제공한다. `tokemon top` 명령어를 통해 실행되는 대시보드는 스파크라인 차트를 포함하여 일일 및 주간 토큰 사용량 트렌드를 시각적으로 보여준다.

터미널 사용자 인터페이스(TUI): — 텍스트 기반 터미널 환경에서 그래픽 요소와 상호작용을 제공하는 인터페이스 방식이다. 마우스 없이 키보드만으로 복잡한 대시보드나 도구를 조작할 수 있게 하여 개발자 도구에서 널리 사용된다.
중복 제거(Deduplication): — 데이터 집합 내에서 중복되는 항목을 식별하고 하나만 남기는 처리 과정이다. 이 아티클에서는 여러 로그 파일에 중복 기록된 API 요청이 비용 계산 시 두 번 합산되지 않도록 방지하는 핵심 로직으로 쓰인다.
스파크라인(Sparkline): — 데이터의 추세를 한눈에 보여주기 위해 텍스트와 함께 표시되는 아주 작은 크기의 차트이다. 터미널 대시보드 내에서 일일 또는 주간 토큰 사용량의 변화 흐름을 직관적으로 파악하게 돕는다.

bash

cargo install tokemon

Rust 패키지 매니저인 Cargo를 사용하여 Tokemon을 설치하는 명령어