# get-token-insights

get-token-insights parses Claude Code conversation history, flags token waste, and generates an offline dashboard covering costs, hooks, and agent workflows.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-memory/skills/get-token-insights/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/get-token-insights

## What it 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.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-memory@Claudest
```
This installs the whole claude-memory plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill get-token-insights -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill get-token-insights -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill get-token-insights -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gupsammy/Claudest plugins/claude-memory/skills/get-token-insights
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill get-token-insights -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-memory/skills/get-token-insights
```

### Windsurf (Devin Desktop)

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

### 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/gupsammy/Claudest/tree/HEAD/plugins/claude-memory/skills/get-token-insights/SKILL.md

## When to use it
- 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
- 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

## Similar
- [token-dashboard-claude-analytics](https://affpapa.org/en/nevibecode/skills/token-dashboard-claude-analytics.md) — skill · 315 installs
- [token-economist](https://affpapa.org/en/nevibecode/agents/token-economist.md) — subagent · ★ 1198 repo stars
- [dashboard](https://affpapa.org/en/nevibecode/skills/rsaryev-dashboard.md) — skill · ★ 171 repo stars
- [insights-advisor](https://affpapa.org/en/nevibecode/agents/insights-advisor.md) — subagent · ★ 1198 repo stars
- [token-dashboard](https://affpapa.org/en/nevibecode/skills/token-dashboard.md) — skill · 477 installs
- [token-efficiency](https://affpapa.org/en/nevibecode/skills/token-efficiency.md) — skill · 2700 installs

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 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
