# token-dashboard

The token-dashboard Claude Code skill reports the cost of past sessions and opens the Token Optimizer dashboard on request. Asking about a cost does not open a browser.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 477 installs · ★ 3042 repo stars
- Author: alexgreensh
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alexgreensh/token-optimizer/tree/HEAD/skills/token-dashboard/SKILL.md
- Updated: 2026-11-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/token-dashboard

## What it does

The skill looks up the cost of a completed session in Token Optimizer, or gathers fresh data and opens the dashboard when asked. The dashboard shows context usage, quality, session history, and skills. Cost figures use API list prices, so they are estimates of subscription work rather than subscription bills.

Token Optimizer must be installed, along with Python 3.9 or later. The skill locates `measure.py` among installed copies and selects a runtime from environment variables. A cost lookup does not launch a browser.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add alexgreensh/token-optimizer --skill token-dashboard -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add alexgreensh/token-optimizer --skill token-dashboard -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add alexgreensh/token-optimizer --skill token-dashboard -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alexgreensh/token-optimizer skills/token-dashboard
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add alexgreensh/token-optimizer --skill token-dashboard -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/alexgreensh/token-optimizer --path skills/token-dashboard
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add alexgreensh/token-optimizer --skill token-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/alexgreensh/token-optimizer/tree/HEAD/skills/token-dashboard/SKILL.md

## When to use it
- retrieve a completed session's cost by name or ID
- check a session's cost for a particular date
- open a dashboard of context usage and session history

## Example prompts
- How much did yesterday's Garden session cost?
- Find the cost for session ID `abc12345`.
- Open the Token Optimizer dashboard.

## Similar
- [codeledger](https://affpapa.org/en/nevibecode/plugins/codeledger.md) — plugin · ★ 9 repo stars
- [token-dashboard-claude-analytics](https://affpapa.org/en/nevibecode/skills/token-dashboard-claude-analytics.md) — skill · 315 installs
- [mm2-analytics-dashboard-roblox](https://affpapa.org/en/nevibecode/skills/mm2-analytics-dashboard-roblox.md) — skill · 2400 installs
- [cost-conversation](https://affpapa.org/en/nevibecode/skills/cost-conversation.md) — skill · 682 installs
- [project-kpi-dashboard](https://affpapa.org/en/nevibecode/skills/project-kpi-dashboard.md) — skill · 123 installs
- [kpi-dashboard](https://affpapa.org/en/nevibecode/skills/datadrivenconstruction-kpi-dashboard.md) — skill · 1 install

From the same set: [alexgreensh/token-optimizer](https://affpapa.org/en/nevibecode/by/alexgreensh/token-optimizer.md) — 5 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
