chop

Active · v1.0.1

🧩 About this project

chop is a CLI output compressor designed specifically for Claude Code.

Claude Code wastes 50–90% of its context window on verbose CLI output — build logs, test results, container listings, git diffs. chop compresses that output before Claude sees it, saving tokens and keeping conversations focused.

It works as a transparent wrapper: prefix any command with chop, or install a global hook that intercepts every Bash command Claude runs automatically.

⚙️ How to use it

Install:

curl -fsSL https://raw.githubusercontent.com/AgusRdz/chop/main/install.sh | sh

Use manually:

chop git status
chop docker ps
chop npm test
chop kubectl get pods
chop terraform plan

Or install the automatic Claude Code hook:

chop init --global   # install
chop init --status   # verify
chop init --uninstall

📦 Supported commands (52+)

Category	Commands	Savings
Git	`git` status/log/diff/branch, `gh` pr/issue/run	50–90%
JavaScript	`npm`, `pnpm`, `yarn`, `bun`, `tsc`, `eslint`, `biome`	70–95%
Angular/Nx	`ng`, `nx` build/test	70–90%
.NET	`dotnet` build/test	70–90%
Go	`go` test/build/vet	75–90%
Python	`pytest`, `pip`, `uv`, `mypy`, `ruff`	70–90%
Containers	`docker`, `docker compose`	60–85%
Kubernetes	`kubectl`, `helm`	60–85%
Infrastructure	`terraform` plan/apply/init	70–90%
Cloud	`aws`, `az`, `gcloud`	60–85%

Any command not listed is auto-detected and compressed via structural pattern matching (JSON, CSV, tables, log lines).

📊 Token tracking

chop gain              # overall stats
chop gain --history    # last 20 commands
chop gain --summary    # per-command breakdown

Every run is tracked in a local SQLite database. No data leaves your machine.

🔧 Technical details

Written in Go — fast, single binary, no runtime dependencies
Installs to ~/bin/ or a custom directory
Cross-platform: Linux, macOS, Windows (amd64 / arm64)
Configuration via ~/.config/chop/config.yml
Local SQLite token tracking

💬 Read more about the motivation behind chop in the blog post.