Choosing your install
Find your platform and surface in the matrix below, then open the matching install page. Each page carries the prerequisites, the exact commands, the verify step, and the uninstall path for that one surface.
The one rule
Section titled “The one rule”Pick a single install method per platform. Never combine the plugin install and the script install on the same machine.
On Claude Code the plugin lives in ~/.claude/plugins/marketplaces/alexgreensh-token-optimizer and the script install lives in ~/.claude/token-optimizer/. Running both produces two copies of the hooks, doubled session writes, and a status line that fights itself. Choose the plugin (every OS) or the script (macOS and Linux only), not both.
Platform and surface matrix
Section titled “Platform and surface matrix”| Platform | Surface | Recommended command | Install page |
|---|---|---|---|
| Claude Code | CLI, all OS | /plugin marketplace add alexgreensh/token-optimizer | Claude Code (CLI) |
| Claude Code | VS Code, Cursor, Devin (formerly Windsurf) | code --install-extension token-optimizer-statusline-<version>.vsix | Claude Code (VS Code) |
| Codex | CLI | codex plugin marketplace add alexgreensh/token-optimizer | Codex (CLI) |
| Codex | Desktop | Same adapter as CLI, no separate install | Codex (Desktop) |
| GitHub Copilot | CLI, beta | bash install.sh --copilot | Copilot (CLI) |
| GitHub Copilot | VS Code, beta | Same adapter, plus one manual settings step | Copilot (VS Code) |
| Google Antigravity | CLI, app, IDE, beta | bash install.sh --antigravity | Antigravity |
| OpenCode | plugin | Add "plugins": ["token-optimizer-opencode"] to opencode.json on V2; use plugin (singular) on V1 | OpenCode |
| OpenClaw | plugin | openclaw plugins install github:alexgreensh/token-optimizer | OpenClaw |
| Hermes | plugin, beta | token-optimizer/install.sh --hermes | Hermes |
| Cursor | IDE and CLI, beta | bash install.sh --cursor | Cursor |
| Grok Build | CLI, contract-only beta | bash install.sh --grok | Grok Build |
| Pi | Extension, experimental | pi install git:github.com/alexgreensh/token-optimizer (unverified end-to-end) | Pi |
| Cowork | Account-synced plugin, experimental | bash install.sh --cowork builds the upload payload | Cowork |
Which surface do I have
Section titled “Which surface do I have”- Claude Code in a terminal: use Claude Code (CLI). The plugin install runs the engine and the hooks.
- Claude Code inside VS Code, Cursor, or Devin (formerly Windsurf): install the CLI plugin first, then add the VS Code extension for the status bar. The extension surfaces what the plugin writes; it is not a standalone install.
- Codex Desktop: install the Codex CLI hooks. Desktop loads the same
~/.codex/hooks.json, so nothing extra installs. See Codex (Desktop) for what differs. - Copilot in VS Code: run the Copilot CLI install, then follow the one manual debug-log step on the Copilot (VS Code) page to turn on per-request credit costs.
Dashboard ports by platform
Section titled “Dashboard ports by platform”Each platform serves its dashboard on its own port, so several can run at once without conflict.
| Platform | Port | URL |
|---|---|---|
| Claude Code (CLI and VS Code) | 24842 | http://localhost:24842/token-optimizer |
| Codex (CLI and Desktop) | 24843 | http://localhost:24843/token-optimizer |
| Hermes | 24844 | http://localhost:24844 |
| Copilot | 24845 | http://localhost:24845/token-optimizer (verify) |
| Cursor | 24846 | http://localhost:24846/token-optimizer (verify) |
| Antigravity | 24847 | http://localhost:24847/token-optimizer |
| Grok Build | 24848 | http://localhost:24848/token-optimizer |
Zero dependencies
Section titled “Zero dependencies”Every Python adapter (Claude Code, Codex, Hermes, Copilot, Cursor, Antigravity, Grok) is pure standard library. No pip install, no telemetry. The TypeScript plugins (OpenCode, OpenClaw) add nothing beyond their host runtime. The main installer checks for Python 3.9+; the Antigravity route also rejects older candidates. Some adapter routes check only that Python exists, not a precise minimum. The repository CI matrix covers Python 3.11-3.14, so use a tested interpreter rather than assuming every 3.x release works. Pi uses its host extension runtime.