Shell Hook

95+ Padrões de Comandos.
Compressão Transparente.

O shell hook intercepta a saída do CLI antes que sua IA a veja. Git diffs, npm installs, cargo builds, docker logs - tudo comprimido à informação essencial. Sem configuração, sem aliases para aprender.

34+ categorias de comandos 95+ padrões específicos 60–90% redução de saída

Fluxo

Como funciona.

O shell hook envelopa seus comandos de forma transparente. A IA vê a saída comprimida - você não percebe nada diferente.

Comando

IA executa git status

Hook

lean-ctx intercepta a saída

Compressão

Redução por correspondência de padrões

Resultado

IA vê saída compacta

34+ Categorias

Todas as ferramentas que você já usa.

lean-ctx reconhece padrões de saída de todas as principais ferramentas de desenvolvimento e comprime cada um com regras desenvolvidas especificamente.

Controle de Versão

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

Containers & Orquestração

docker ps docker build docker logs kubectl get kubectl describe

Python

pip install pytest python -m poetry uv

Sistema & Utilitários

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

Antes & Depois

Veja a diferença.

Sem 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

Com 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%)]

Mais Exemplos

Cada comando, comprimido.

npm install - bruto ~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 - bruto ~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 independentemente

O shell hook opera independentemente do servidor de contexto. Ferramentas de IA que ainda não foram configuradas também se beneficiam da saída comprimida do shell. O hook intercepta no nível do shell, então toda ferramenta que executa comandos obtém economia.

Cursor Claude Code GitHub Copilot Aider Any shell-based AI

Cobertura

Cobertura de padrões em um relance.

34+

Categorias de comandos

95+

Padrões específicos

87%

Compressão git média

Configuração necessária

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.

Precisa da saída completa? Use o modo bruto.

Quando você precisa da saída não comprimida, ignore a compressão com uma única flag. Sem perda silenciosa de dados - o truncamento é sempre 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)

Comece a economizar com cada comando.

Um comando de configuração habilita o shell hook para seu shell. Todo comando de IA a partir daí é comprimido automaticamente.

Começar Agora Explorar Ferramentas de Contexto

95+ Padrões de Comandos.Compressão Transparente.