Referência CLI

Comandos para Humanos.
Resultados para IA.

O lean-ctx funciona automaticamente após a configuração. Mas quando você quiser controle, estes comandos estão à disposição.

O essencial

Comandos Essenciais

lean-ctx setup

Configuração única. Detecta automaticamente seu shell (zsh/bash/fish), encontra ferramentas de IA instaladas, configura MCP e shell hooks. Execute uma vez e nunca mais pense nisso.

Execute uma vez após a instalação
lean-ctx init

Configuração rápida para uma ferramenta de IA específica. Use --agent cursor, --agent claude, --agent codex ou --agent gemini para configurar o MCP diretamente para essa ferramenta.

Alternativa por agente ao setup
lean-ctx gain

Veja seu painel de economias. Economia vitalícia de tokens, taxas de compressão, principais comandos e estimativas de custo em USD. Persistente em todas as sessões.

Consulte a qualquer momento
Saiba exatamente o que você economiza

Monitoramento & Insights

lean-ctx gain

Painel de economias vitalício com contagens de tokens, taxa de compressão, principais comandos e acompanhamento de custos em USD.

$ lean-ctx gain

◆ lean-ctx Token Savings Dashboard

────────────────────────────────

1.7M saved 76.8% rate $4.25 USD

Top Commands

curl 48x ████████████ 728K

git 34x ██████ 375K

lean-ctx gain --live

Painel ao vivo com atualização automática. Atualiza a cada 2 segundos conforme suas ferramentas de IA economizam tokens em tempo real.

● LIVE

$ lean-ctx gain --live

◆ lean-ctx LIVE refreshing every 2s

────────────────────────────────

1.7M saved ▁▃█▇██▁█

Session: 42 cmds | 89.2K saved | 94.1% rate

Press q to quit

lean-ctx gain --graph

Gráfico de economias de 30 dias com barras diárias, sparklines e visualização de tendências. Veja a trajetória das suas economias.

$ lean-ctx gain --graph

Token Savings (30 days)

03-20██████████████████████ 1.0M

03-21███████████████ 690K

03-22████████████████████████ 1.1M

03-23 9.4K

03-24██████████████████████ 1.7M

lean-ctx dashboard

Painel web em localhost:3333. Gráficos interativos, histórico de sessões e monitoramento em tempo real no seu navegador.

$ lean-ctx dashboard

◆ lean-ctx Dashboard

→ http://localhost:3333

Interactive charts, session history, command breakdown

Press Ctrl+C to stop

lean-ctx wrapped

"Spotify Wrapped" das suas economias de tokens. Relatórios bonitos e compartilháveis com suas estatísticas vitalícias, principais comandos e conquistas pessoais de compressão.

weekly monthly lifetime

$ lean-ctx wrapped monthly

◆ Your March 2026 Wrapped

────────────────────────────────

4.9M tokens saved

3,241 commands compressed

$12.16 USD saved

Top pattern: curl (97% compression)

You're in the top 5% of lean-ctx users

Verificar e otimizar

Diagnósticos

lean-ctx doctor

Executa 8 verificações de instalação - binário, shell hook, configuração MCP, arquivo de estatísticas, diretório de cache, shell compatível, detecção de ferramenta de IA e verificação de versão.

Binary installed

Shell hook active (zsh)

MCP config (Cursor)

Stats persistence

Cache directory

Data directory writable

Project detection

Graph index

Search index

Agent hooks

Version up to date

All 11 checks passed

lean-ctx discover

Analisa seu histórico de shell em busca de comandos que poderiam se beneficiar da compressão mas ainda não estão sendo interceptados.

Found 12 uncompressed commands:

kubectl - 34 calls, ~89% savings possible

helm - 12 calls, ~76% savings possible

terraform - 8 calls, ~82% savings possible

Run setup to enable these

lean-ctx benchmark run

Mede as economias reais de tokens na sua base de código usando tiktoken (o200k_base). Números exatos, sem estimativas.

src/auth.ts (123 lines)

full: 3,517 → 3,517 (0%)

map: 3,517 → 412 (88%)

signatures: 3,517 → 252 (93%)

entropy: 3,517 → 312 (91%)

Controle total

Comandos para Usuários Avançados

Comando Descrição
lean-ctx init --agent <name> Configuração rápida de MCP para uma ferramenta de IA específica (cursor, claude, codex, gemini, windsurf, copilot, cline, roo, pi, qwen, trae, amazonq, jetbrains)
lean-ctx read <file> -m <mode> Leia qualquer arquivo com um modo de compressão (full, map, signatures, diff, aggressive, entropy). Leituras em cache retornam ~13 tokens. Use --fresh para ignorar o cache.
lean-ctx diff Git diff comprimido - saída estruturada com resumos de alterações
lean-ctx grep <pattern> Busca de padrões eficiente em tokens com contexto compacto
lean-ctx find <pattern> Encontre arquivos por nome - resultados compactos com contagem de arquivos
lean-ctx ls Listagem de diretório como um mapa de árvore compacto
lean-ctx -c "<cmd>" Comprima a saída de qualquer comando shell arbitrário através do lean-ctx
lean-ctx config set <key> <value> Configure as opções do lean-ctx - intervalos de checkpoint, TTL do cache, modo CRP
lean-ctx cache [stats|clear|invalidate] Gerenciar cache CLI - ver estatísticas, limpar entradas ou invalidar caminhos específicos
lean-ctx setup Configuração com um comando - configura hooks de shell, MCP do editor e verifica se tudo funciona

Pronto para ver suas economias?

Instale o lean-ctx, execute setup e comece a economizar tokens imediatamente. Verifique seu painel com gain quando quiser.