Shell Hook

95+ patrones de comandos.
Compresión transparente.

El shell hook intercepta la salida del CLI antes de que tu IA la vea. Diffs de Git, instalaciones de npm, builds de cargo, logs de docker - todo comprimido a su información esencial. Sin configuración, sin alias que aprender.

34+ categorías de comandos 95+ patrones específicos 60–90% reducción de salida

Flujo

Cómo funciona.

El shell hook envuelve tus comandos de forma transparente. La IA ve la salida comprimida - tú no notas ninguna diferencia.

Comando

La IA ejecuta git status

Hook

lean-ctx intercepta la salida

Compresión

Reducción por coincidencia de patrones

Resultado

La IA ve la salida compacta

34+ categorías

Cada herramienta que ya usas.

lean-ctx reconoce patrones de salida de todas las herramientas de desarrollo principales y comprime cada una con reglas diseñadas específicamente.

Control de versiones

git status git diff git log git branch git stash git remote

JavaScript / Node

npm install npm run npm test yarn pnpm tsc

Rust

cargo build cargo test cargo clippy cargo check cargo run

Contenedores y orquestación

docker ps docker build docker logs kubectl get kubectl describe

Python

pip install pytest python -m poetry uv

Sistema y utilidades

ls / find ps / top curl make env cat / head

Antes y después

Mira la diferencia.

Sin shell hook ~580 tokens

git status

On branch feature/auth
Your branch is ahead of 'origin/feature/auth'
by 3 commits.
  (use "git push" to publish your local
   commits)

Changes to be committed:
  (use "git restore --staged <file>..."
   to unstage)
        new file:   src/session.ts
        modified:   src/login.ts
        modified:   src/api.ts

Changes not staged for commit:
  (use "git add <file>..." to update
   what will be committed)
  (use "git restore <file>..." to
   discard changes in working directory)
        modified:   src/session.ts

Untracked files:
  (use "git add <file>..." to include
   in what will be committed)
        src/session.test.ts

Con shell hook ~75 tokens

git status (compressed)

feature/auth ↑3
staged: +session.ts ~login.ts ~api.ts
unstaged: ~session.ts
untracked: session.test.ts
[534 tok saved (87%)]

Más ejemplos

Cada comando, comprimido.

npm install - sin comprimir ~420 tokens

npm install

npm warn deprecated inflight@1.0.6:
  This module is not supported...
npm warn deprecated glob@7.2.3:
  Glob versions prior to v9...
npm warn deprecated rimraf@3.0.2:
  Rimraf versions prior to v4...

added 847 packages, and audited
848 packages in 12s

127 packages are looking for funding
  run `npm fund` for details

found 0 vulnerabilities

npm install - comprimido ~35 tokens

npm install (compressed)

✓ 847 packages 12s
⚠ 3 deprecated (inflight, glob, rimraf)
0 vulnerabilities
[385 tok saved (92%)]

cargo build - sin comprimir ~310 tokens

cargo build

   Compiling proc-macro2 v1.0.86
   Compiling unicode-ident v1.0.12
   Compiling syn v2.0.72
   Compiling serde_derive v1.0.204
   Compiling serde v1.0.204
   Compiling tokio v1.39.2
   Compiling lean-ctx v2.1.0
    Finished `dev` profile [unoptimized
    + debuginfo] target(s) in 24.3s

cargo build - comprimido ~30 tokens

cargo build (compressed)

✓ build dev 24.3s
7 crates compiled
[280 tok saved (90%)]

Funciona de forma independiente

El shell hook opera independientemente del servidor de contexto. Las herramientas de IA que aún no se han configurado también se benefician de la salida comprimida del shell. El hook intercepta a nivel del shell, por lo que toda herramienta que ejecute comandos obtiene ahorros.

Cursor Claude Code GitHub Copilot Aider Any shell-based AI

Cobertura

Cobertura de patrones de un vistazo.

34+

Categorías de comandos

95+

Patrones específicos

87%

Compresión promedio de git

Configuración requerida

Docker & Container Environments

In containers, non-interactive shells skip ~/.bashrc. Set BASH_ENV to point at lean-ctx's dedicated env.sh file, which has no interactive-mode guard. For Claude Code, also set CLAUDE_ENV_FILE.

# In your Dockerfile:
ENV BASH_ENV="/root/.lean-ctx/env.sh"
ENV CLAUDE_ENV_FILE="/root/.lean-ctx/env.sh"

lean-ctx includes self-healing: if the env.sh file is removed (e.g., by a container rebuild), lean-ctx init --global re-creates it automatically.

¿Necesitas la salida completa? Usa el modo raw.

Cuando necesitas la salida sin comprimir, omite la compresión con un solo flag. Sin más pérdida silenciosa de datos - el truncamiento siempre es transparente.

# CLI flag - skip compression for one command
lean-ctx -c --raw kubectl get pods -o yaml

# Shell function - quick bypass
lean-ctx-raw gh pr view 42

# Kill-switch - disable ALL compression
LEAN_CTX_DISABLED=1 lean-ctx -c git log

# MCP parameter - for AI agents
ctx_shell(command="cat config.json", raw=true)

Comienza a ahorrar con cada comando.

Un comando de configuración habilita el shell hook para tu shell. Cada comando de IA posterior se comprime automáticamente.

Comenzar Explorar herramientas de contexto

95+ patrones de comandos.Compresión transparente.