Skip to content
Token Optimizer

Quickstart

This is the fastest path on Claude Code. Install the plugin, run the audit one time, and open the dashboard. Everything else runs automatically from there.

For other platforms, or for a script-managed install on macOS and Linux, see Choosing your install.

Install and run

Section titled “Install and run”

  1. Add the marketplace and install the plugin. In Claude Code:

    /plugin marketplace add alexgreensh/token-optimizer
    /plugin install token-optimizer@alexgreensh-token-optimizer

    This is the recommended path on macOS, Linux, and Windows. The plugin auto-loads its hooks on install, so Smart Compaction, quality scoring, active compression, and session data collection start working without manual setup.

  2. Turn on auto-update. Claude Code ships third-party marketplaces with auto-update off, and plugin authors cannot change that default. Go to /plugin, open the Marketplaces tab, select alexgreensh-token-optimizer, and choose Enable auto-update. One time, ten seconds, and you receive fixes automatically.

  3. Run the audit once. In Claude Code:

    /token-optimizer

    It scans your setup, finds waste, shows you the findings on a dashboard, and applies the fixes you approve. See Reading your first audit for what each phase produces and how to act on it.

  4. Open the dashboard. The dashboard regenerates after every session. To make it available at a bookmarkable URL, install the daemon once from the scripts directory:

    Terminal window
    cd ~/.claude/skills/token-optimizer/scripts
    python3 measure.py setup-daemon

    Then open http://localhost:24842/token-optimizer. The dashboard binds to localhost by default, reachable only from your own machine.

Confirm it worked

Section titled “Confirm it worked”

Run the health check from the scripts directory:

Terminal window
cd ~/.claude/skills/token-optimizer/scripts
python3 measure.py doctor

doctor reports pass, warn, or fail for each component: hooks, status line, Smart Compaction, dashboard daemon, and quality bar. For a quick context-fill and quality read instead, run /token-optimizer quick.

Next steps

Section titled “Next steps”