chop

Active · v1.0.1

🧩 Sobre este proyecto

chop es un compresor de salidas CLI diseñado específicamente para Claude Code.

Claude Code desperdicia entre el 50 y el 90% de su ventana de contexto en salidas verbosas del terminal — logs de builds, resultados de tests, listados de contenedores, diffs de git. chop comprime esa salida antes de que Claude la vea, ahorrando tokens y manteniendo las conversaciones enfocadas.

Funciona como un wrapper transparente: antepone chop a cualquier comando, o instala un hook global que intercepta automáticamente cada comando Bash que Claude ejecuta.

⚙️ Cómo usarlo

Instalar:

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

Uso manual:

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

O instalar el hook automático de Claude Code:

chop init --global   # instalar
chop init --status   # verificar
chop init --uninstall

📦 Comandos soportados (52+)

Categoría	Comandos	Ahorro
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%
Contenedores	`docker`, `docker compose`	60–85%
Kubernetes	`kubectl`, `helm`	60–85%
Infraestructura	`terraform` plan/apply/init	70–90%
Nube	`aws`, `az`, `gcloud`	60–85%

Cualquier comando fuera de esta lista se detecta automáticamente y se comprime mediante reconocimiento de patrones estructurales (JSON, CSV, tablas, líneas de log).

📊 Seguimiento de tokens

chop gain              # estadísticas generales
chop gain --history    # últimos 20 comandos
chop gain --summary    # desglose por comando

Cada ejecución se registra en una base de datos SQLite local. Ningún dato sale de tu máquina.

🔧 Detalles técnicos

Escrito en Go — rápido, binario único, sin dependencias de runtime
Se instala en ~/bin/ o en un directorio personalizado
Multiplataforma: Linux, macOS, Windows (amd64 / arm64)
Configuración mediante ~/.config/chop/config.yml
Seguimiento de tokens con SQLite local

💬 Lee más sobre la motivación detrás de chop en el post del blog.