token-optimizer — Claude Code plugin: what it does, how to install
token-optimizer cuts token usage 60-90% in Claude Code and Codex using caching, compression, and selective file reading.
MIT ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install token-optimizer@awesome-codex-pluginsWhat token-optimizer does
The plugin manages context window consumption across Claude Code and Codex sessions. It lowers token usage by 60-90% through data caching, compression, and specialised file tools.
File handling avoids loading full contents repeatedly. It relies on diff-only re-reads, paths-only search routines, and temporary out-of-context stashing.
You also get a per-tool savings breakdown, tracking where tokens were saved during interactions.
What it helps with
- lower token consumption by 60-90% during coding sessions
- inspect file modifications via diff-only re-reads
- run paths-only searches without dumping file contents into context
- generate a per-tool token savings report
Example prompts for the agent
- Search for project files returning paths only to save tokens
- Re-read modified files using diffs only
- Show the per-tool savings report for this session
How to install token-optimizer
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install token-optimizer@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about token-optimizer
How to install token-optimizer in Claude Code?
Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then run /plugin install token-optimizer@awesome-codex-plugins.
What does token-optimizer do?
It minimizes context window usage in Claude Code and Codex by 60-90% using caching, compression, diff re-reads, and out-of-context stashing.
Does token-optimizer show token metrics?
Yes, it provides a per-tool savings report detailing the exact token reductions achieved by each tool.
Source text
token-optimizer-mcp · MIT
Cut token usage 60-90% with caching, compression, and smart file tools — diff-only re-reads, paths-only search, out-of-context stashing, and a per-tool savings report for Codex and Claude Code.
© ooples · MIT · hashgraph-online/awesome-codex-plugins