Token Dashboard

Name: Token Dashboard
Author: alexgreensh

alexgreensh/token-optimizer

301 installs
1.8k repo stars
Updated August 3, 2026
alexgreensh/token-optimizer

Monitor and visualize LLM token usage, cost drivers, and optimization opportunities via the token-optimizer dashboard during agent development and production runs.

About

Token dashboard skill from token-optimizer for tracking LLM token consumption, analyzing cost drivers, comparing model efficiency, and guiding prompt and context optimizations through operational visibility dashboards.

Token usage metrics
Cost driver analysis
Model efficiency comparison
Optimization recommendations
Operational spend visibility

Token Dashboard by the numbers

301 all-time installs (skills.sh)
Ranked #2,258 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
Data as of Aug 5, 2026 (Skillselion catalog sync)

npx skills add https://github.com/alexgreensh/token-optimizer --skill token-dashboard

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/alexgreensh/token-optimizer/token-dashboard.svg)](https://skillselion.com/skills/alexgreensh/token-optimizer/token-dashboard)

Installs	301
repo stars	★ 1.8k
Last updated	August 3, 2026
Repository	alexgreensh/token-optimizer ↗

What it does

Monitor and visualize LLM token usage, cost drivers, and optimization opportunities via the token-optimizer dashboard during agent development and production runs.

Files

SKILL.mdMarkdownGitHub ↗

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:

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:

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.