@tokmizer/plugin
v0.5.15
Published
Tokmizer reduces token consumption for AI coding tools (Claude Code, Codex, Cursor, Aider, Gemini CLI, Cline, Windsurf, Copilot). Cross-OS.
Maintainers
Readme
Tokmizer
Tokmizer reduces token consumption for AI coding tools: Claude Code, OpenAI Codex, Cursor, Aider, Gemini CLI, Cline, Windsurf, and GitHub Copilot. Works on macOS, Linux, and Windows.
It compresses noisy command output (logs, diffs, listings, test runs) before it reaches the model. Your agent does more work with the same context window, and you pay for fewer tokens.
Install
In Claude Code:
/plugin marketplace add Impulse-Creation/Tokmizer
/plugin install tokmizerAny other tool (universal shell-shim):
curl -fsSL https://tokmizer.com/install.sh | bashWindows (PowerShell):
npm install -g @tokmizer/plugin
tkr shim installSee scripts/README-INSTALL.md for per-tool notes.
Free tier
Optimization starts automatically. The free tier needs no account. To unlock Smart or Pro, subscribe at tokmizer.com, then:
tkr linkCommands
In Claude Code:
/tkrshows or changes settings/tkr-link tokmizer_yourkeylinks a paid account/tkr-unlinkunlinks this machine from your account/tkr-gainshows tokens saved/tkr-statusshows your current plan and usage/tkr-compressionpicks the compression level (light, balanced, max)/tkr-reducermakes the assistant's replies shorter (off, light, balanced, max). Smart and Pro/tkr-telemetryviews or changes anonymous telemetry/tkr-updateupdates the plugin when a new version is out
From any terminal:
tkr statusshows your current plan and statustkr gainshows tokens savedtkr link <key>links a paid accounttkr unlinkunlinks this machinetkr compression light|balanced|maxpicks how hard output gets compressed (default balanced)tkr reducer off|light|balanced|maxmakes the assistant's replies shorter (default off). Smart and Protkr settings show|set|configuremanages settings and syncs them across your machines
What's in this repository
The user-facing parts of the Tokmizer plugin:
- Plugin manifests for Claude Code (
.claude-plugin/,hooks/) and Codex (codex-plugin/) - The
/tkrslash commands (commands/) - Install scripts for macOS, Linux, and Windows (
scripts/) - Selected plugin sources (
src/): session UI, local stats and usage tracking, host detection, and the telemetry redaction rules that strip secrets before anything leaves your machine
The optimization engine and the API client are proprietary. They ship compiled with the @tokmizer/plugin npm package and are not part of this repository.
Privacy
- Telemetry is opt-in (
telemetryOptIn, default off). - Before any usage event is recorded,
src/learn/redact.tsstrips passwords, API keys, tokens, and cloud credentials. You can audit those rules here. - Local state lives in
~/.tokmizer/.
License
Proprietary. See LICENSE and the EULA at tokmizer.com/eula.
