Token Optimizer

What Token Optimizer is

Token Optimizer is a plugin published in the alexgreensh/token-optimizer repository on GitHub, which has about 2.4k stars. The repository describes itself as: “Find the ghost tokens. Fix them. Survive compaction. Avoid context quality decay.”

A plugin is a package that bundles skills, slash commands, subagents, hooks, and MCP connectors so they install together. Plugins are plain files with a manifest at .claude-plugin/plugin.json, and they work in both Claude Code and Claude Cowork.

Installing Token Optimizer adds everything it ships in one step. Connectors inside a plugin still need to be connected separately, and hooks and subagents only run in Cowork and Claude Code, not in regular chat.

How to install Token Optimizer

New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.

Inside the source file

The repository does not declare an open-source license, so we list only the outline of the file here. Read the full text on GitHub.

• The 30-Second Version
• Install
• What You Get
• How It's Different
• The Dashboard
• What It Saves
• Active Compression
• Delta Mode
• Structure Map
• First-Read Skeleton
• Bash Output Compression
• Custom Command Filters (TOML)
• Search Result Compression
• Lean-Output Nudges

Open plugin.json on GitHub

Before you install

• Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
• Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
• Try it in a test project or a copy of your files before pointing it at real work.
• Pin the version you tested, and review changes before updating.
• Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.

FAQ