> ## 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 = ""}) => {
  const [darkMode, setDarkMode] = useState(null);
  useEffect(() => {
    const root = document.documentElement;
    const syncTheme = () => setDarkMode(root.classList.contains("dark"));
    const observer = new MutationObserver(syncTheme);
    syncTheme();
    observer.observe(root, {
      attributes: true,
      attributeFilter: ["class"]
    });
    return () => observer.disconnect();
  }, []);
  if (darkMode === null) return null;
  return <img src={darkMode ? dark ?? light : light} alt={alt} loading="lazy" />;
};

# 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 — 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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.