token-dashboard — Claude Code skill: session costs and installation
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.
no license 477 installs ★ 3,042 updated 2026-11-12
npx skills add alexgreensh/token-optimizer --skill token-dashboard -a claude-codeWhat token-dashboard 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.
What it helps with
- 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 for the agent
- How much did yesterday's Garden session cost?
- Find the cost for session ID
abc12345. - Open the Token Optimizer dashboard.
How to install token-dashboard
1Skills CLI (Vercel)
npx skills add alexgreensh/token-optimizer --skill token-dashboard -a claude-code2Manually: put the files in place
~/.claude/skills/token-dashboard/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/token-dashboard/
1Skills CLI (Vercel)
npx skills add alexgreensh/token-optimizer --skill token-dashboard -a codex2Manually: put the files in place
.agents/skills/token-dashboard/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add alexgreensh/token-optimizer --skill token-dashboard -a cursor2Manually: put the files in place
.cursor/skills/token-dashboard/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install alexgreensh/token-optimizer skills/token-dashboard2Manually: put the files in place
.github/skills/token-dashboard/SKILL.md1Skills CLI (Vercel)
npx skills add alexgreensh/token-optimizer --skill token-dashboard -a gemini-cli2Platform CLI
gemini skills install https://github.com/alexgreensh/token-optimizer --path skills/token-dashboardManually: put the files in place
.devin/skills/token-dashboard/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add alexgreensh/token-optimizer --skill token-dashboard -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about token-dashboard
How do I install token-dashboard in Claude Code?
Run npx skills add alexgreensh/token-optimizer --skill token-dashboard -a claude-code. The skill installs to ~/.claude/skills/token-dashboard/SKILL.md.
What does token-dashboard do?
It looks up costs for completed sessions and opens the Token Optimizer dashboard on request. The dashboard includes context usage, quality, session history, and skills.
What does token-dashboard need to run?
It needs Token Optimizer installed and Python 3.9 or later. Cost figures use API list prices, so they are not subscription bills.