# codeburn-claude-cost-dashboard

Skill runs the CodeBurn terminal dashboard to inspect Claude Code token expenses. It analyzes local session files on disk without API keys or proxy setups.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 546 installs · ★ 88
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/codeburn-claude-cost-dashboard/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/codeburn-claude-cost-dashboard

## What it does

This tool brings a terminal interface for monitoring coding agent costs. CodeBurn parses JSONL logs stored inside `~/.claude/projects/` directly. It reads model names, token counts, and tool executions. To prevent inflated numbers across overlapping runs, it deduplicates entries using API message IDs.

Sessions get organized into 13 deterministic activity groups, including coding, debugging, planning, and testing. For file modifications, the dashboard tracks a one-shot rate that shows how often the model succeeded without retry cycles. Pricing details come from LiteLLM and stay cached for 24 hours in `~/.cache/codeburn/`.

Running this tool requires Node.js 20 or newer alongside an active Claude Code setup. If `~/.claude/projects/` contains no session data, the dashboard cannot display any stats.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill codeburn-claude-cost-dashboard -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/codeburn-claude-cost-dashboard/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/codeburn-claude-cost-dashboard/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill codeburn-claude-cost-dashboard -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/codeburn-claude-cost-dashboard/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill codeburn-claude-cost-dashboard -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/codeburn-claude-cost-dashboard/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills codeburn-claude-cost-dashboard
```

2. **Manually: put the files in place**
- File: `.github/skills/codeburn-claude-cost-dashboard/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill codeburn-claude-cost-dashboard -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/codeburn-claude-cost-dashboard
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/codeburn-claude-cost-dashboard/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill codeburn-claude-cost-dashboard -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/codeburn-claude-cost-dashboard/SKILL.md

## When to use it
- inspect Claude Code token expenses across projects
- break down spending by model and activity category
- calculate one-shot success rates on code modifications
- export session metrics to JSON and CSV files

## Example prompts
- Check my Claude Code spending for today
- Launch the CodeBurn dashboard to review model token costs
- Export my session usage report to JSON

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 199 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md