> ## Documentation Index
> Fetch the complete documentation index at: https://panopticon-cli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Token Spend Report

> Live analysis of Overdeck's AI token consumption, costs, and codebase evolution

export const ThemedImage = ({light, dark, alt = ""}) => <>
    <img src={light} alt={alt} className="block dark:hidden" />
    <img src={dark ?? light} alt={alt} className="hidden dark:block" />
  </>;

# Token Spend Report

Overdeck tracks every API call, token, and dollar spent across its AI coding pipeline. This interactive report visualizes that data — from model breakdowns to monthly trajectories to the actual codebase evolution video.

<iframe src="https://eltmon.github.io/overdeck/token-spend-report/" width="100%" height="1400" style={{ border: "none", borderRadius: "8px", background: "#0f172a" }} />

## What's Inside

This published report is a point-in-time snapshot. For live spend while agents
and conversations are running, the dashboard's **Cost Tracking** page tracks the
same SQLite + JSONL event streams in real time — total cost, event count, budget
warnings, a 30-day trend chart, and a per-issue breakdown.

<ThemedImage light="/images/dashboard/costs-light.png" dark="/images/dashboard/costs-dark.png" alt="Cost Tracking page showing total cost, event count, budget warnings, a 30-day cost-trend chart, and per-issue costs" />

The report pulls from two data sources:

* **SQLite** (`~/.overdeck/panopticon.db`) — February 2025 through March 2026
* **JSONL** (`~/.overdeck/costs/events.jsonl`) — Canonical from March 31, 2026 onward (includes OpenAI GPT-5.5/5.4)

### Key Sections

| Section                     | What It Shows                                                        |
| --------------------------- | -------------------------------------------------------------------- |
| **Hero Stats**              | Total spend, calls, tokens, and commits                              |
| **Model Breakdown**         | Top 10 models by cost (Claude, GPT, Kimi, MiniMax)                   |
| **Provider Split**          | Cost distribution across Anthropic, OpenAI, Kimi, MiniMax            |
| **Pipeline Stages**         | Cost by session type: work, plan, review, test, merge                |
| **Monthly Trajectory**      | Bar chart of spend over time (with Jan 2026 incomplete-data warning) |
| **Top Issues by Spend**     | Which issues consumed the most tokens                                |
| **Subscription Comparison** | What pay-per-use would cost vs. actual subscription spend            |
| **Cache Savings**           | Tokens and dollars saved from prompt caching                         |
| **Cost-Reduction Features** | RTK, Caveman, TLDR — what's working and what's not                   |
| **Codebase Timelapse**      | Gource visualization of the entire git history                       |

## Beyond Cost: Runtime Metrics

Cost is only half the picture. The dashboard's **Metrics** page pairs the spend
data above with runtime comparison and performance analytics — useful when
deciding which model to route a given role to, since the cheapest model per call
isn't always the cheapest per completed task.

<ThemedImage light="/images/dashboard/metrics-light.png" dark="/images/dashboard/metrics-dark.png" alt="Metrics page showing runtime comparison and performance analytics" />

## Regenerating the Report

The report is generated by the `/token-spend-report` skill. To update it:

1. Run the skill: `/token-spend-report`
2. The skill extracts fresh data from SQLite + JSONL
3. Updates the HTML at `docs/token-spend-report/index.html`
4. Optionally regenerates the Gource video
5. Commits and pushes to GitHub Pages

The skill lives at `~/.claude/skills/token-spend-report/SKILL.md` and is synced via `pan sync`.

## GitHub Pages

The report is hosted directly from the repo's `docs/` folder via GitHub Pages:

```
https://eltmon.github.io/overdeck/token-spend-report/
```

This is a zero-cost static site that updates automatically on every push to `main`.

## Data Freshness

* **Last updated:** 2026-05-25
* **Data through:** 2026-05-25
* **Git history through:** 2026-05-25 (6,463 commits)
* **Total tracked calls:** 734,117
* **Total spend:** \$54,116