Token Optimizer

What is Token Optimizer?

Token Optimizer is a plugin and skill for AI coding agents, primarily Claude Code, that shows where your context window and spend go and trims what does not need to be there. An audit workflow scans your setup and produces a per-component token breakdown, while a local SQLite history feeds trends, savings and per-turn cost reports and a single-file HTML dashboard. Active compression rewrites safe read-only CLI output into short summaries, returns only the diff when a changed file is re-read, and archives large tool results so they can be expanded later. Smart compaction saves checkpoints at several context-fill bands and restores them afterward, and a 0 to 100 quality score based on seven signals appears in the status line with warnings and loop detection. Measurement runs locally on your machine. It is licensed under PolyForm Noncommercial 1.0.0 with a written permission for small businesses: personal, hobby, research and education use is free, and companies under 5 people and $20k/month revenue need no paid license.

Use cases

• Audit wasted tokens in Claude Code sessions
• Track token and dollar cost per session
• Recover a session after context compaction
• Compress noisy command output before it fills context
• Score context quality while coding
• Reorder CLAUDE.md for better model attention

Who it's for

• Claude Code users
• Developers using coding agents
• Teams watching AI spend

Why use Token Optimizer

• Shows which sessions, models and skills cost the most, so you can cut waste with evidence.
• Checkpoints protect long sessions from losing state when auto-compact runs.
• Full source is published, so you can audit what it reads from transcripts before trusting it.
• Free for personal use and for very small businesses under the stated size and revenue limits.

Token Optimizer features

• Full audit with per-component token breakdown and suggestions
• Single-file HTML dashboard of overview, quality and trends
• Trends, savings and per-turn cost reports from a local database
• Bash and search output compression
• Delta mode that returns only the diff on re-reads of changed files
• Checkpoint capture and restore around compaction
• 0 to 100 context quality score with status line display
• Loop detection and quality nudges
• Token Coach and Fleet Auditor for behavior and multi-agent audits
• Attention optimizer that scores and reorders CLAUDE.md

Token Optimizer integrations

• Claude Code
• Codex

How to get started with Token Optimizer

1. Install Token Optimizer as a plugin or skill for your coding agent.
2. Run the audit or quick scan to see overhead, top offenders and degradation risk.
3. Let the default hooks compress output, cache reads and save checkpoints as you work.
4. Open the dashboard or run the trends and savings commands to review cost and realized savings.
5. Use the checkpoint restore after compaction or on a fresh session to pick up where you stopped.

Token Optimizer limitations

• Licensed PolyForm Noncommercial 1.0.0; companies above 4 people or $20k/month revenue need a commercial license
• Work done for an employer counts as the employer's use, even on a personal laptop
• Some commands write settings or end processes, so not every report is read-only

Token Optimizer pricing

Token Optimizer is free to use.

Token Optimizer plans

• Personal and education

  Free

  • Full source
  • Runs locally
  • Hobby, research and education use

• Small business

  Free

  Under 5 people and $20k/month revenue

  • No-cost commercial license granted in writing
  • Internal business use only

• Commercial license

  Custom

  Contact the author

  • For larger organizations
  • Terms scale with company size

Plans as listed on the official pricing page on 24 Oct 2026. Prices can change and may vary by country or exclude tax. Check the official pricing page.

Token Optimizer alternatives

The main Token Optimizer alternatives listed on Debuly are Langfuse, Helicone, WhereMyTokens, agent-top, Poirot and Supercode. The table compares pricing and platforms; order is A–Z.

1. 

   agent-top

   Terminal dashboard that lists every local Claude Code, Codex, Gemini CLI and OpenCode session with its state, tokens and cost.

   CodingDeveloper platformsProductivity
   Visit agent-top (official site)
2. 

   Helicone

   Open-source LLM observability and AI gateway that logs requests, tracks cost and latency, and routes to 100+ models through one API.

   Developer platformsCoding
   FreemiumVisit Helicone (official site)
3. 

   Langfuse

   Open-source LLM observability and evaluation platform for tracing agents, managing prompts and scoring outputs.

   Developer platformsAutomation and agentsCoding
   FreemiumVisit Langfuse (official site)
4. 

   Poirot

   Free, open-source macOS app that shows what Claude Code did in each session, with usage analytics and cost views.

   CodingDeveloper platformsProductivity
   Open sourceVisit Poirot (official site)
5. 

   Supercode

   Extension for Claude, Codex and Cursor that trims token use, adds project context and offers a catalog of agent skills.

   CodingAutomation and agentsDeveloper platforms
   PaidVisit Supercode (official site)
6. WM

   WhereMyTokens

   Local-first Windows tray app that tracks Claude Code, Codex and Antigravity token use, quota windows and cost estimates.

   CodingProductivityDeveloper platforms
   Open sourceVisit WhereMyTokens (official site)

Token Optimizer FAQ

Sources & verification

Facts on this page come from the official sources below, each with the date we read it. Written by Debuly; the vendor did not review this page.

Image credits

• Logo: from token-optimizer.dev · fetched 24 Oct 2026 · Vendor trademark, used only to identify the product; removed on request
• Cover: none collected yet, so a generated tile is shown.

Spot an error? Report an issue with this listing. We also remove a logo or image on the owner's request.