CodeBurn – AI 코딩 에이전트 토큰 사용량 시각화 TUI 대시보드

핵심 특징 / 차별점
주요 기능
인터랙티브 대시보드
프로바이더별 조회
태스크 13개 카테고리 자동 분류
1-shot 성공률
macOS 메뉴바 위젯
설치
지원 프로바이더
라이선스
관련 문서

AI 코딩 에이전트를 매일 쓰다 보면 자연스럽게 드는 궁금증이 있다. “지금까지 얼마나 썼지? 어디에 토큰을 가장 많이 쓰고 있지?” CodeBurn은 Claude Code, Codex, Cursor, OpenCode 등 주요 AI 코딩 도구의 토큰 사용량과 비용을 디스크에 저장된 세션 데이터를 직접 읽어 TUI 대시보드로 시각화하는 오픈소스 CLI 도구다. 래퍼나 프록시 없이 동작하며, API 키도 필요 없다.

핵심 특징 / 차별점

항목	CodeBurn	각 도구 내장 통계
멀티 프로바이더 통합	Claude Code + Codex + Cursor + OpenCode	각자 별도
태스크 유형별 분류	13개 카테고리 자동 분류	없음
1-shot 성공률 추적	있음	없음
인터랙티브 TUI	그래디언트 차트, 키보드 탐색	없음
macOS 메뉴바 위젯	SwiftBar 연동	없음
CSV/JSON 내보내기	있음	제한적
비용 표시 통화	162개 ISO 4217 통화 지원	USD 고정

주요 기능

인터랙티브 대시보드

codeburn              # 대화형 대시보드 (기본: 7일)
codeburn today        # 오늘 사용량
codeburn month        # 이번 달 사용량

←→ 화살표로 Today / 7 Days / 30 Days / Month 전환. q로 종료.

프로바이더별 조회

codeburn report --provider claude   # Claude Code만
codeburn report --provider codex    # Codex만
codeburn report --provider cursor   # Cursor만

태스크 13개 카테고리 자동 분류

LLM 호출 없이 도구 사용 패턴과 키워드로 완전 결정론적(deterministic) 분류:

카테고리	트리거 조건
Coding	Edit, Write 도구
Debugging	Error/fix 키워드 + 도구 패턴
Feature Dev	“add”, “create”, “implement”
Refactoring	“refactor”, “rename”
Testing	pytest, vitest, jest (Bash)
Exploration	Read/Grep/WebSearch, 수정 없음
Planning	EnterPlanMode, TaskCreate
Delegation	Agent 도구 호출

1-shot 성공률

Edit → Bash → Edit 패턴을 감지해 재시도 없이 첫 번째 시도에 성공한 비율을 계산한다. Coding 90%는 AI가 10번 중 9번 첫 시도에 코드를 완성했다는 뜻이다.

macOS 메뉴바 위젯

codeburn install-menubar   # SwiftBar 플러그인 설치

SwiftBar 설치 후 사용. 5분마다 갱신되며 오늘 비용을 불꽃 아이콘과 함께 메뉴바에 표시한다.

설치

npm install -g codeburn
# 또는 설치 없이 바로 실행
npx codeburn

Node.js 20 이상 필요.

지원 프로바이더

프로바이더	데이터 경로
Claude Code	`~/.claude/projects/`
Claude Desktop	`~/Library/Application Support/Claude/local-agent-mode-sessions/`
Codex (OpenAI)	`~/.codex/sessions/`
Cursor	`~/Library/Application Support/Cursor/User/globalStorage/state.vscdb`
OpenCode	`~/.local/share/opencode/` (SQLite)

라이선스

MIT 라이선스. GitHub: AgentSeal/codeburn npm: codeburn

AI Sparkup