llms.txt@docs · diff

git:20260809.7d871fc to git:20260919.8bd664b

18 added, 4 removed. Audit A to A.

# Token-Saver

> Content-aware output compression for AI coding assistants. A Claude Code

> and Antigravity CLI plugin that intercepts verbose CLI command output

> (git, pytest, npm, terraform, kubectl, docker, and more) and compresses it

> deterministically before it reaches the model, using 36 specialized

- > processors — one per tool family. No LLM calls, no network access,

- > fully offline. Typical savings: 60-99% per command, with all errors,

- > diffs, and stack traces preserved by design.

+ > processors — one per tool family. Compression runs locally without LLM

+ > calls or output uploads. An optional release check contacts GitHub. Savings

+ > depend on the output and use character-based token estimates. Error

+ > preservation is covered by representative fixtures and configurable limits.

## Start here

+ - [Quick Start](https://github.com/ppgranger/token-saver/blob/main/README.md#quick-start): Plugin installation and first steps.

- [Home](https://ppgranger.github.io/token-saver/): Overview and quick start.

- [Benchmarks](https://ppgranger.github.io/token-saver/benchmarks/): 22 measured compression scenarios, gated by CI, with methodology.

- - [How It Compares](https://ppgranger.github.io/token-saver/comparison/): Token-Saver vs cc_token_saver_mcp, token-optimizer-mcp, Claude Context Mode.

+ - [How It Compares](https://ppgranger.github.io/token-saver/comparison/): Token-Saver, RTK, and Context Mode: command compression and context retrieval.

- [FAQ](https://ppgranger.github.io/token-saver/faq/): Common questions on privacy, precision, platform support.

- [Full README](https://github.com/ppgranger/token-saver/blob/main/README.md): Installation, architecture, configuration reference.

+ - [Compression quality gates](https://ppgranger.github.io/token-saver/quality-gates/): Offline compression and replay checks for saved logs, token budgets, and required diagnostics.

+ - [Architecture](https://ppgranger.github.io/token-saver/architecture/): Component responsibilities and extension points for contributors.

## Processors (one page per tool family)

- [git](https://ppgranger.github.io/token-saver/processors/git/): status, diff, log, show, push/pull/fetch, branch, stash, blame.

- [test_output](https://ppgranger.github.io/token-saver/processors/test_output/): pytest, jest, go test, cargo test and other test runners.

- [lint_output](https://ppgranger.github.io/token-saver/processors/lint_output/): eslint, ruff, pylint, clippy, mypy and other linters.

- [build_output](https://ppgranger.github.io/token-saver/processors/build_output/): Build tool output across major ecosystems.

- [docker](https://ppgranger.github.io/token-saver/processors/docker/): Docker CLI and Docker Compose output.

- [kubectl](https://ppgranger.github.io/token-saver/processors/kubectl/): kubectl and oc (OpenShift) commands.

- [terraform](https://ppgranger.github.io/token-saver/processors/terraform/): Terraform and OpenTofu commands.

- [cargo](https://ppgranger.github.io/token-saver/processors/cargo/): Rust's cargo build system.

- [cargo_clippy](https://ppgranger.github.io/token-saver/processors/cargo_clippy/): Rust clippy lint output.

- [go](https://ppgranger.github.io/token-saver/processors/go/): Go toolchain commands.

- [maven_gradle](https://ppgranger.github.io/token-saver/processors/maven_gradle/): Maven and Gradle build output.

- [python_install](https://ppgranger.github.io/token-saver/processors/python_install/): Python package installation output (pip).

- [package_list](https://ppgranger.github.io/token-saver/processors/package_list/): pip list, npm ls, and other package listing commands.

- [helm](https://ppgranger.github.io/token-saver/processors/helm/): Helm CLI output for chart management.

- [ansible](https://ppgranger.github.io/token-saver/processors/ansible/): ansible-playbook and ansible command output.

- [cloud_cli](https://ppgranger.github.io/token-saver/processors/cloud_cli/): aws, gcloud, az and other cloud provider CLIs.

- [gh](https://ppgranger.github.io/token-saver/processors/gh/): GitHub CLI (gh) output.

- [db_query](https://ppgranger.github.io/token-saver/processors/db_query/): Database query result output.

- [jq_yq](https://ppgranger.github.io/token-saver/processors/jq_yq/): Large JSON/YAML output from jq and yq.

- [network](https://ppgranger.github.io/token-saver/processors/network/): HTTP client output (curl, wget).

- [search](https://ppgranger.github.io/token-saver/processors/search/): grep, find, ripgrep output.

- [file_listing](https://ppgranger.github.io/token-saver/processors/file_listing/): Directory listing commands (ls, tree, find).

- [file_content](https://ppgranger.github.io/token-saver/processors/file_content/): Content-aware compression for file viewing commands.

- [ssh](https://ppgranger.github.io/token-saver/processors/ssh/): Non-interactive SSH and SCP output.

- [structured_log](https://ppgranger.github.io/token-saver/processors/structured_log/): JSON Lines log output from log tailing tools.

- [syslog](https://ppgranger.github.io/token-saver/processors/syslog/): journalctl and dmesg output.

- [system_info](https://ppgranger.github.io/token-saver/processors/system_info/): Disk and file counting commands.

- [env](https://ppgranger.github.io/token-saver/processors/env/): Environment variable listing commands.

- [generic](https://ppgranger.github.io/token-saver/processors/generic/): Fallback processor for unrecognized commands.

+ - [act](https://ppgranger.github.io/token-saver/processors/act/): Compress local GitHub Actions logs from act while retaining workflow output, step results, job status, and recognized errors.

+ - [bun](https://ppgranger.github.io/token-saver/processors/bun/): Compress Bun package installation output, retaining package changes, summaries, and recognized warnings and errors.

+ - [cdktf](https://ppgranger.github.io/token-saver/processors/cdktf/): Compress CDK for Terraform output using the Terraform plan and apply processor after filtering synthesis and compilation progress.

+ - [just](https://ppgranger.github.io/token-saver/processors/just/): Compact long just recipe listings with recipe counts, an explicit overflow marker, and recognized errors.

+ - [mise](https://ppgranger.github.io/token-saver/processors/mise/): Reduce mise runtime installation progress while preserving installation results and recognized warnings and errors.

+ - [nix](https://ppgranger.github.io/token-saver/processors/nix/): Summarize Nix build and store-transfer output with counts while retaining recognized diagnostics and plan summaries.

+ - [pulumi](https://ppgranger.github.io/token-saver/processors/pulumi/): Compact Pulumi infrastructure updates and previews while retaining resource operations, output summaries, and recognized diagnostics.

## Optional

- [Source repository](https://github.com/ppgranger/token-saver): Full source, issue tracker, releases.

- [Custom Processors Guide](https://github.com/ppgranger/token-saver/blob/main/examples/custom_processor/README.md): How to write and register your own processor.

+ - [Contributing](https://github.com/ppgranger/token-saver/blob/main/CONTRIBUTING.md): Development setup, test suite, and contribution conventions.

- [License](https://github.com/ppgranger/token-saver/blob/main/LICENSE): Apache-2.0.