Skill1.3k repo starsupdated today

token-dashboard

The token-dashboard skill collects current session data and generates an interactive HTML dashboard displaying context usage trends, quality scores, session history, and skill management metrics. Use it to monitor token consumption patterns and optimize Claude interactions across sessions by opening a real-time overview in your default browser.

View source Repository: token-optimizer

Install in Claude Code

Copy

git clone --depth 1 https://github.com/alexgreensh/token-optimizer /tmp/token-dashboard && cp -r /tmp/token-dashboard/skills/token-dashboard ~/.claude/skills/token-dashboard

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Token Optimizer Dashboard

Opens an up-to-date dashboard showing your context usage trends, quality scores, session history, and skill management.

## Instructions

1. **Resolve runtime and measure.py path**:
```bash
RUNTIME="${TOKEN_OPTIMIZER_RUNTIME:-}"
if [ -z "$RUNTIME" ]; then
  if [ -n "$CLAUDE_PLUGIN_ROOT" ] || [ -n "$CLAUDE_PLUGIN_DATA" ]; then
    RUNTIME="claude"
  elif [ -n "$CODEX_HOME" ] || [ -d "$HOME/.codex" ]; then
    RUNTIME="codex"
  else
    RUNTIME="claude"
  fi
fi

MEASURE_PY=""
for f in "$HOME/.codex/skills/token-optimizer/scripts/measure.py" \
         "$HOME/.codex/plugins/cache"/*/token-optimizer/*/skills/token-optimizer/scripts/measure.py \
         "$HOME/.claude/skills/token-optimizer/scripts/measure.py" \
         "$HOME/.claude/plugins/cache"/*/token-optimizer/*/skills/token-optimizer/scripts/measure.py; do
  [ -f "$f" ] && MEASURE_PY="$f" && break
done
[ -z "$MEASURE_PY" ] && { echo "[Error] measure.py not found. Is Token Optimizer installed?"; exit 1; }
export TOKEN_OPTIMIZER_RUNTIME="$RUNTIME"
```

2. **Collect and open**:
```bash
python3 "$MEASURE_PY" collect --quiet && python3 "$MEASURE_PY" dashboard
```

This collects the latest session data into the trends database, regenerates the dashboard HTML, and opens it in your default browser.

3. **Tell the user** the dashboard is open. URL-first ordering (v5.3.3+):
   - Probe daemon: `python3 "$MEASURE_PY" daemon-status 2>/dev/null`
   - If DAEMON_RUNNING: lead with `URL: http://localhost:24842/token-optimizer` (bookmarkable, auto-updates), then mention the file fallback.
   - For Claude Code file fallback: `File: ~/.claude/_backups/token-optimizer/dashboard.html`.
   - For Codex file fallback: `File: ~/.codex/_backups/token-optimizer/dashboard.html`.
   - If DAEMON_NOT_RUNNING in Claude Code: suggest `python3 $MEASURE_PY setup-daemon` (macOS and Windows).
   - If DAEMON_NOT_RUNNING in Codex: do not imply the Claude daemon is required; the generated file works, and Stop hooks refresh it when balanced hooks are installed.