Token-Saver

Keep the signal. Stop rereading the same failures.

Token-Saver compresses the terminal output your AI coding assistant reads — git diff, pytest, npm install, terraform plan, kubectl, docker — to leave more room for the code, instructions, and next decision. Compression runs locally, without another model call or an output upload.

New in v3: Delta. Run your tests, edit, run again: see which failures are new, changed, or unchanged. Fresh diagnostics keep their full details; repeated ones can become a short inventory, with details available on demand. Delta is an experimental, opt-in feature in 3.0.0 for supported pytest and Ruff commands in Claude Code.

36 specialized processors cover git, pytest, jest, cargo, go, docker, kubernetes, terraform, pulumi, helm, ansible, aws, gcloud, and more. Their rules reduce progress logs and boilerplate, with failure fixtures and optional quality contracts checking important diagnostics.

Ordinary compression supports Claude Code and Antigravity CLI. It runs automatically after installation. Results depend on the command and output; already concise or unsupported output may stay unchanged.

Why developers use Token-Saver:

• 💸 Less output to process — many benchmark scenarios save 60-99% of estimated output tokens; billing impact depends on your usage and provider.
• 🔁 See what changed — opt-in Delta compares repeated pytest/Ruff runs and keeps retained details one command away.
• 🪟 Bigger effective context — fit more real work into the same context window.
• 🎯 Tested preservation — failure fixtures check important diagnostics; add quality contracts for your own workflows.
• 🔌 Install once, forget it — works automatically in the background, no prompts to change.
• 🛡️ Local compression — pure regex/parsing with no network calls in the compression path.

---

Table of Contents

• Before & After
• Quick Start
• Why Token-Saver Exists
• Who It's For
• What Gets Compressed — Real Examples
• How It Compares
• How It Works
• Precision Guarantees
• Installation
• CLI Reference
• Delta: Changes Between Runs
• Compression Quality Gates
• Processors
• Configuration
• Tuning Recipes
• Custom Processors
• Savings Tracking
• Security & Privacy
• Performance
• FAQ
• Troubleshooting
• Known Limitations
• Project Structure
• Tests
• Contributing

---

Before & After