get-token-insights — Claude Code skill: what it does, how to install
get-token-insights parses Claude Code conversation history, flags token waste, and generates an offline dashboard covering costs, hooks, and agent workflows.
no license ★ 276 updated 2026-10-29
/plugin marketplace add gupsammy/Claudest
/plugin install claude-memory@ClaudestWhat get-token-insights does
The skill processes conversation logs in ~/.claude/projects/*/ through ingest_token_data.py. It calculates expenses across individual projects and models, tracks hook latency, and measures prompt cache misses. A dedicated claude-code-guide subagent then processes the telemetry to draft targeted cost reduction advice.
Output appears directly in the terminal and compiles into a standalone report at ~/.claude-memory/dashboard.html. When rapid five-minute cache invalidation drains tokens, the workflow can install protective scripts into ~/.claude/hooks/ after backing up settings.json.
Parsing around 2500 files during the initial pass takes roughly 100 seconds, while subsequent runs take under 5 seconds. The tool requires python3 in your environment.
What it helps with
- uncover root causes of token overspending in Claude Code sessions
- render an offline HTML dashboard tracking spend and agent metrics
- spot slow or failing hooks across active configurations
- evaluate financial losses triggered by frequent prompt cache invalidation
Example prompts for the agent
- Analyze my token consumption and suggest cost reductions
- Review hook runtimes and subagent delegation patterns from recent logs
- Generate the spend dashboard in ~/.claude-memory/dashboard.html
How to install get-token-insights
1Plugin marketplace
/plugin marketplace add gupsammy/Claudest/plugin install claude-memory@ClaudestThis installs the whole claude-memory plugin with all its skills
2Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill get-token-insights -a claude-code3Manually: put the files in place
~/.claude/skills/get-token-insights/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/get-token-insights/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill get-token-insights -a codex2Manually: put the files in place
.agents/skills/get-token-insights/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill get-token-insights -a cursor2Manually: put the files in place
.cursor/skills/get-token-insights/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gupsammy/Claudest plugins/claude-memory/skills/get-token-insights2Manually: put the files in place
.github/skills/get-token-insights/SKILL.md1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill get-token-insights -a gemini-cli2Platform CLI
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-memory/skills/get-token-insightsManually: put the files in place
.devin/skills/get-token-insights/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.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 get-token-insights
How to install get-token-insights in Claude Code?
Add the repository and install the plugin using /plugin marketplace add gupsammy/Claudest, followed by /plugin install claude-memory@Claudest.
What does get-token-insights do?
It parses project conversation files, highlights model spending, assesses prompt caching efficiency, and builds an HTML analytics report.
What dependencies does this skill require?
It relies on a working python3 installation and read access to ~/.claude/projects/.