Referência CLI

Esta é a referência completa para cada comando do lean-ctx. Para uma folha de referência rápida, consulte a Referência Rápida. Para detalhes de analytics e painéis, consulte o Guia de Analytics.

Compressão de Shell

Estes comandos executam comandos shell através dos mais de 95 padrões de compressão do lean-ctx. A saída é automaticamente limpa de ruído, boilerplate e redundância antes de chegar ao LLM.

lean-ctx -c "<command>"

Execute qualquer comando shell e comprima sua saída. Alias: lean-ctx exec.

lean-ctx -c "git status"
lean-ctx -c "kubectl get pods -A"
lean-ctx -c "cargo build 2>&1"
lean-ctx exec "docker ps"

O shell hook (instalado via lean-ctx init) torna isso automático para comandos comuns - você não precisa prefixá-los com -c. Use -c explicitamente para comandos não cobertos pelo shell hook.

lean-ctx shell

Inicie uma sessão de shell interativa onde toda saída de comando é comprimida. Encapsula seu shell padrão (zsh, bash ou fish).

lean-ctx shell
# Now every command output is compressed automatically
git log --oneline -20
docker compose logs
# Exit with Ctrl+D or 'exit'

Modo Raw

Pule a compressão completamente quando precisar de saída completa e não modificada. Três formas de ativar:

# CLI flag
lean-ctx -c --raw git log --stat

# Shell function (after lean-ctx init --global)
lean-ctx-raw kubectl get pods -o yaml

# MCP parameter
ctx_shell(command="cat package.json", raw=true)

# Environment variable
LEAN_CTX_RAW=1 lean-ctx -c npm list

# Bypass command - guaranteed zero compression
lean-ctx bypass "git diff HEAD~1"

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

lean-ctx bypass "<command>"

Execute qualquer comando com zero compressão garantida. Internamente define LEAN_CTX_RAW=1 antes de executar o comando. Use quando precisar de certeza absoluta de que a saída não foi modificada.

lean-ctx bypass "git diff HEAD~1"     # guaranteed unmodified output
lean-ctx bypass "docker logs myapp"   # no compression, no truncation
lean-ctx bypass "npm audit"           # raw vulnerability report

Dica: bypass é equivalente a LEAN_CTX_RAW=1 lean-ctx -c "command" mas mais conveniente. A string do comando é passada diretamente ao shell.

Operações de Arquivo

Acesso direto via CLI às ferramentas de leitura, busca e navegação de arquivos do lean-ctx. Essas são as mesmas operações que o MCP server oferece às ferramentas de IA.

lean-ctx read <file> [-m <mode>]

Leia um arquivo com modo de compressão opcional. O modo padrão é full.

lean-ctx read src/main.rs                    # auto-selects best mode
lean-ctx read src/main.rs -m full            # full content (cached)
lean-ctx read src/main.rs -m map             # dependency graph + exports
lean-ctx read src/main.rs -m signatures      # tree-sitter AST extraction
lean-ctx read src/main.rs -m aggressive      # syntax-stripped
lean-ctx read src/main.rs -m entropy         # Shannon entropy filtered
lean-ctx read src/main.rs -m diff            # changed lines only
lean-ctx read src/main.rs -m task            # IB-filtered for current task
lean-ctx read src/main.rs -m reference       # cross-reference context
lean-ctx read src/main.rs -m lines:10-50     # specific line range
lean-ctx read src/main.rs -m lines:10-50,80  # multiple ranges

lean-ctx diff <file1> <file2>

Diff comprimido entre dois arquivos com resumos estruturados de alterações.

lean-ctx diff old.rs new.rs

lean-ctx grep <pattern> [path]

Pesquise conteúdo de arquivos com resultados comprimidos e agrupados. Usa ripgrep internamente.

lean-ctx grep "pub fn" src/
lean-ctx grep "TODO" .
lean-ctx grep "async fn.*Result" rust/src/

lean-ctx find <pattern> [path]

Encontre arquivos por padrão de nome. Respeita o .gitignore e gera uma árvore de arquivos compacta.

lean-ctx find "*.rs" src/
lean-ctx find "test_*" .

lean-ctx ls [path]

Listagem de diretório compacta como um mapa de árvore com contagem de arquivos.

lean-ctx ls
lean-ctx ls src/components/

lean-ctx deps [path]

Exiba o grafo de dependências do projeto. Detecta o gerenciador de pacotes e extrai as dependências.

lean-ctx deps .
lean-ctx deps frontend/

Modos de Leitura

Os modos de leitura controlam como o lean-ctx read e a ferramenta MCP ctx_read comprimem o conteúdo dos arquivos. Escolha o modo certo para seu caso de uso:

Linguagens suportadas para o modo signatures: TypeScript, JavaScript, Rust, Python, Go, Java, C, C++, Ruby, C#, Kotlin, Swift, PHP (14 no total via tree-sitter).

Setup e Configuração

lean-ctx setup

Setup com um único comando. Detecta automaticamente seu shell (zsh/bash/fish/PowerShell), encontra ferramentas de IA instaladas e configura MCP server + shell hooks. Execute uma vez após instalar o lean-ctx.

lean-ctx setup

Isso executa três etapas internamente:

1. Instala aliases de shell (init --global)
2. Configura o MCP para cada ferramenta de IA detectada
3. Verifica se tudo funciona (doctor)

Since v3.3.3, the setup wizard includes a Premium Features step where you can configure Terse Agent Mode, Tool Result Archive, and Output Density interactively.

lean-ctx init [--global | <shell>]

Instale os aliases de compressão shell no perfil do seu shell.

# File-based: writes aliases directly into your shell profile
lean-ctx init           # install for current shell
lean-ctx init --global  # same, explicit flag

# Eval-based: prints hook code to stdout (like starship, zoxide, atuin)
eval "$(lean-ctx init bash)"        # bash: add to ~/.bashrc
eval "$(lean-ctx init zsh)"         # zsh: add to ~/.zshrc
lean-ctx init fish | source         # fish: add to config.fish
lean-ctx init powershell | Invoke-Expression  # PowerShell: add to $PROFILE

Isso grava um bloco no ~/.zshrc, ~/.bashrc, ~/.config/fish/config.fish ou no perfil do seu PowerShell. O bloco inclui aliases para git, docker, npm, cargo e mais de 95 outros comandos.

Padrão eval: O método eval imprime código de hook no stdout, garantindo que sempre corresponda à versão do binário instalado. É o mesmo padrão usado por starship, zoxide e atuin. Os hooks nunca ficam desatualizados após atualizações.

lean-ctx init --agent <name>

Configure o MCP para uma ferramenta de IA específica sem executar o setup completo.

lean-ctx init --agent cursor
lean-ctx init --agent claude
lean-ctx init --agent codex
lean-ctx init --agent gemini
lean-ctx init --agent antigravity  # alias for gemini
lean-ctx init --agent windsurf
lean-ctx init --agent copilot
lean-ctx init --agent cline
lean-ctx init --agent roo
lean-ctx init --agent aider
lean-ctx init --agent continue
lean-ctx init --agent zed
lean-ctx init --agent void
lean-ctx init --agent amp
lean-ctx init --agent trae
lean-ctx init --agent kilo
lean-ctx init --agent opencode
lean-ctx init --agent pi           # installs pi-lean-ctx npm package
lean-ctx init --agent custom       # generic MCP config

lean-ctx config [set <key> <value>]

Exiba ou edite a configuração armazenada em ~/.lean-ctx/config.toml.

lean-ctx config                        # show current config
lean-ctx config set ultra_compact true # enable ultra-compact mode
lean-ctx config set tee_on_error true  # log errors to ~/.lean-ctx/tee/
lean-ctx config set checkpoint_interval 20

Settable Configuration Keys

lean-ctx config set theme neon
lean-ctx config set slow_command_threshold_ms 3000
lean-ctx config set passthrough_urls "localhost:3000,api.example.com"
lean-ctx config set rules_scope both

lean-ctx doctor

Execute 8 diagnósticos de instalação e ambiente:

• Binário instalado e no PATH
• Shell hook ativo
• Configuração MCP para editores detectados
• Persistência do arquivo de estatísticas
• Diretório de cache
• Shell compatível detectado
• Detecção de ferramenta de IA
• Verificação de versão
• Rules injection status
• Claude Code instructions (rules + skill installed)
• Build integrity verification

lean-ctx doctor

lean-ctx update [--check]

Auto-atualização do binário lean-ctx a partir do GitHub Releases.

lean-ctx update         # download and install latest version
lean-ctx update --check # check if a newer version is available (no install)

lean-ctx login <email> [--password <pw>] v3.3.3

Authenticate with LeanCTX Cloud. Only attempts login - does not create a new account. If password is omitted, prompts interactively.

lean-ctx login user@example.com
lean-ctx login user@example.com --password mypassword

On success, saves the API key to ~/.lean-ctx/cloud/credentials.json and syncs your data. If your email is not yet verified, you'll receive a reminder to check your inbox.

lean-ctx register <email> [--password <pw>] v3.3.3

Create a new LeanCTX Cloud account. Separate from login - no auto-fallback. A verification email is sent after registration.

lean-ctx register user@example.com
lean-ctx register user@example.com --password mypassword

lean-ctx forgot-password <email>

Request a password reset email for an existing LeanCTX Cloud account.

lean-ctx forgot-password user@example.com

lean-ctx uninstall

Remova toda a configuração do lean-ctx: shell hooks, configurações MCP de todos os editores e o diretório de dados ~/.lean-ctx/. Exibe instruções para remover o binário.

lean-ctx uninstall

Analytics e Painéis

Para um guia detalhado com capturas de tela e interpretações, consulte o Guia de Analytics.

lean-ctx gain [flags]

Painel visual no terminal mostrando economias vitalícias de tokens.

Powered by GainEngine - uma API unificada de observabilidade que consolida metricas de compressao, custos e analiticas de sessao em um GainScore (0–100). Usa ModelPricing embutido (sem rede) e um TaskClassifier com 13 categorias.

Modificadores

lean-ctx gain                          # overview with GainScore
lean-ctx gain --score                  # GainScore breakdown
lean-ctx gain --cost --model=claude-4-sonnet  # cost for specific model
lean-ctx gain --tasks                  # task classification heatmap
lean-ctx gain --agents                 # multi-agent cost attribution
lean-ctx gain --deep                   # full deep-dive report
lean-ctx gain --wrapped --period=week  # weekly summary
lean-ctx gain --live                   # real-time monitoring
lean-ctx gain --graph                  # ASCII savings graph
lean-ctx gain --daily                  # daily breakdown
lean-ctx gain --pipeline               # per-stage compression breakdown
lean-ctx gain --json > stats.json      # machine-readable export

A ferramenta MCP ctx_gain oferece as mesmas analiticas via API: agentes podem consultar economia de tokens, custos e GainScore durante a sessao. Veja Referencia de ferramentas MCP.

lean-ctx cep [--json]

Relatório de impacto do CEP (Cognitive Efficiency Protocol) mostrando tendências de pontuação, taxas de acerto de cache e distribuição de modos.

Internally uses ctx_gain --score to compute the Context Efficiency Protocol score. The CEP score ranges from 0–100 and measures how efficiently context is being utilized across read modes, shell compression, and deduplication.

lean-ctx cep               # show CEP score with breakdown
lean-ctx cep --json        # JSON output for CI/CD integration

lean-ctx dashboard [--port=N] [--project=<path>]

Abra o painel web interativo em http://localhost:3333. Possui gráficos interativos, histórico de sessões, agentes ativos e painéis de conhecimento do projeto.

lean-ctx dashboard                        # opens at localhost:3333
lean-ctx dashboard --port=8080            # custom port
lean-ctx dashboard --project=~/my-app     # scoped to a single project

lean-ctx wrapped [--week|--month|--all]

Gere um cartão-relatório "Wrapped" compartilhável das suas economias de tokens.

lean-ctx wrapped
lean-ctx wrapped --month
lean-ctx wrapped --all

Gerenciamento de Sessão

lean-ctx sessions [list|show|cleanup]

Gerencie sessões CCP (Context Continuity Protocol) armazenadas em ~/.lean-ctx/sessions/.

lean-ctx sessions list
lean-ctx sessions show
lean-ctx sessions cleanup

lean-ctx session

Exiba estatísticas de adoção - quanto do seu fluxo de trabalho usa compressão do lean-ctx.

lean-ctx session

Gestão de Conhecimento

Acesso completo via CLI ao armazenamento de conhecimento persistente do projeto. Fatos, padrões e convenções sobrevivem entre sessões e permitem compreensão cumulativa do projeto.

lean-ctx knowledge remember <value> --category <c> --key <k>

Armazena um fato na base de conhecimento do projeto com pontuação de confiança opcional.

lean-ctx knowledge remember "Uses JWT for auth" --category auth --key token-type
lean-ctx knowledge remember "PostgreSQL 16" --category arch --key database --confidence 0.95

lean-ctx knowledge recall [query] [--category <c>] [--mode auto|semantic|hybrid]

Recupera fatos por texto de consulta ou categoria. Suporta recuperação semântica quando embeddings estão habilitados.

lean-ctx knowledge recall "authentication"
lean-ctx knowledge recall --category security
lean-ctx knowledge recall "auth" --mode semantic

lean-ctx knowledge search <query>

Pesquisa em todos os projetos e sessões por fatos correspondentes.

lean-ctx knowledge search "database migration"

lean-ctx knowledge export [--format json|jsonl|simple] [--output <path>]

Exporta a base de conhecimento do projeto. Saída para stdout por padrão (compatível com pipes). Três formatos: json (nativo completo, padrão), jsonl (um fato por linha), simple (array compatível com a comunidade para migração de outras ferramentas).

lean-ctx knowledge export                                  # full JSON to stdout
lean-ctx knowledge export --format jsonl --output backup.jsonl  # JSONL to file
lean-ctx knowledge export --format simple | jq '.[].key'   # pipe-friendly

lean-ctx knowledge import <path> [--merge replace|append|skip-existing] [--dry-run]

Importa fatos de um arquivo JSON, JSONL ou de exportação nativa. Detecta automaticamente o formato de entrada. A estratégia de merge padrão é skip-existing (segura — nunca sobrescreve).

lean-ctx knowledge import backup.json --dry-run             # preview changes
lean-ctx knowledge import facts.jsonl --merge replace        # overwrite existing
lean-ctx knowledge import migration.json --merge skip-existing

lean-ctx knowledge remove --category <c> --key <k>

Remove um fato específico da base de conhecimento.

lean-ctx knowledge remove --category auth --key token-type

lean-ctx knowledge status

Mostra resumo da base de conhecimento — contagem de fatos, categorias e última atualização.

lean-ctx knowledge status

lean-ctx knowledge health

Relatório de saúde com métricas de qualidade, detecção de fatos obsoletos e equilíbrio de espaço.

lean-ctx knowledge health

Benchmarking

lean-ctx benchmark run [path] [--json]

Execute benchmarks reais de tokens nos arquivos do seu projeto usando tiktoken (o200k_base). Mede economias exatas para cada modo de leitura em cada arquivo.

lean-ctx benchmark run                # benchmark current directory
lean-ctx benchmark run src/           # benchmark specific path
lean-ctx benchmark run . --json       # output as JSON

lean-ctx benchmark report [path]

Gere um relatório compartilhável em Markdown a partir dos resultados do benchmark.

lean-ctx benchmark report             # generate report for current directory
lean-ctx benchmark report src/ > BENCHMARK.md

Tee e Filtros

lean-ctx tee [list|clear|show <file>|last]

Gerencie arquivos tee de saída completa salvos em ~/.lean-ctx/tee/. Use lean-ctx tee last para ver a saída salva mais recente. Configure via tee_mode: always, failures ou never.

lean-ctx filter [list|validate|init]

Gerencie filtros de compressão personalizados em ~/.lean-ctx/filters/*.toml.

# Create example filter
lean-ctx filter init

# List loaded filters
lean-ctx filter list

# Validate filter syntax
lean-ctx filter validate

Utilitários

lean-ctx discover

Analise seu histórico de shell em busca de comandos que poderiam se beneficiar da compressão mas não estão sendo interceptados. Mostra estimativas de tokens por comando e projeção de economia em USD.

lean-ctx discover

lean-ctx ghost [--json]

Reveals hidden token waste in your workflow - shows unoptimized shell commands, redundant reads, and oversized contexts with a monthly USD savings estimate. Use --json for CI integration.

lean-ctx ghost
lean-ctx ghost --json

lean-ctx cheatsheet

Imprima uma folha de referência rápida e compacta de todos os comandos e fluxos de trabalho diretamente no seu terminal.

lean-ctx cheatsheet

lean-ctx tee [list|clear|show <file>]

Gerencie arquivos de log de erro armazenados em ~/.lean-ctx/tee/. Quando tee_on_error está habilitado na configuração, comandos com falha registram sua saída completa aqui.

lean-ctx tee list
lean-ctx tee show 2026-03-29_10-30.log
lean-ctx tee clear

lean-ctx slow-log [list|clear]

Exiba ou limpe o log de comandos lentos em ~/.lean-ctx/slow-commands.log. Comandos que demoram mais do que o esperado são registrados aqui para depuração.

lean-ctx slow-log list
lean-ctx slow-log clear

Graph do projeto

Construir ou inspecionar o dependency graph do projeto. O graph indexa relacionamentos entre arquivos (imports, exports, símbolos) e é usado para heat-ranking, análise de intenção e pré-carregamento inteligente.

lean-ctx graph build

Escanear o diretório do projeto e construir o índice do dependency graph. O graph também é construído automaticamente quando ferramentas MCP são usadas.

lean-ctx graph build

Heat Map de contexto

Visualizar a densidade de token dos arquivos e a conectividade do dependency graph como uma heat map codificada por cores. Arquivos com alta contagem de token e muitas conexões aparecem mais quentes.

lean-ctx heatmap

Exibir uma heat map no terminal de todos os arquivos do projeto atual, ordenados por pontuação de calor (combinação de contagem de token e conectividade do graph).

lean-ctx heatmap

Níveis de Segurança

O LeanCTX categoriza cada comando suportado em um nível de segurança que determina quão agressivamente a saída é comprimida. Níveis mais altos nunca removem informações críticas de segurança (erros, CVEs, status de saúde).

lean-ctx safety-levels

Exibe uma tabela detalhada mostrando exatamente como cada tipo de comando é comprimido, quais dados são preservados e quais recursos globais de segurança estão ativos.

lean-ctx safety-levels

Recursos globais de segurança se aplicam a TODOS os níveis: varredura de agulhas de segurança (preserva CRITICAL, FATAL, panic, CVE-*, OOMKilled, etc.), taxa de proteção (bloqueia compressão >95%), detecção de autenticação (mascara tokens/senhas) e limiar mínimo de tokens (sem compressão abaixo de 50 tokens).

Aliases de Shell

Após executar lean-ctx init --global, estes aliases ficam disponíveis no seu shell. Eles permitem ativar e desativar a compressão sem reiniciar:

lean-ctx-status    # check current state
lean-ctx-off       # temporarily disable for human reading
git log            # now shows full, uncompressed output
lean-ctx-on        # re-enable for AI sessions

Quando desativar: Desligue a compressão quando quiser ler a saída dos comandos você mesmo (depuração, revisão de logs). Reative antes de iniciar uma sessão de codificação com IA.

Server & Services

lean-ctx can run as a long-lived HTTP server, a TUI watcher, or a network proxy. These modes are useful for CI/CD pipelines, multi-agent orchestration, and headless environments.

lean-ctx serve [flags] feature: http-server

Start an HTTP/REST server that exposes all MCP tools as REST endpoints. Requires the http-server feature gate. Supports both stateful (session-persisted) and stateless modes.

# Start server with defaults
lean-ctx serve

# Public-facing with rate limits
lean-ctx serve --host=0.0.0.0 --port=8080 --rate-limit=50

# Stateless mode for CI/CD
lean-ctx serve --stateless --timeout=60000

# With CORS for web dashboard
lean-ctx serve --cors --port=9119

Once running, all MCP tools are available at POST /v1/tools/<tool_name>. A health endpoint is at GET /health.

lean-ctx watch

Start lean-ctx in TUI (Terminal UI) mode with a live event bus. Monitors all MCP activity in real time and writes events to ~/.lean-ctx/events.jsonl for post-hoc analysis.

lean-ctx watch                          # full TUI with live event stream
lean-ctx watch --filter=ctx_shell       # only shell events
lean-ctx watch --no-tui                 # headless JSONL to stdout

lean-ctx proxy <start|stop|status> feature-gated

Manage the lean-ctx network proxy. When active, the proxy intercepts MCP traffic and applies compression transparently. Requires the proxy feature gate.

lean-ctx proxy start       # start proxy daemon
lean-ctx proxy status      # check if proxy is running
lean-ctx proxy stop        # stop the proxy

Terse Agent

The Terse Agent controls output density for AI agent communication. It persists across sessions and can be toggled at any time. See also the Configuration guide.

lean-ctx terse [lite|full|ultra|off]

Query or set the Terse Agent mode. Without arguments, shows the current mode. With an argument, sets the mode persistently.

lean-ctx terse              # show current terse mode
lean-ctx terse lite         # set to lite mode
lean-ctx terse full         # set to full mode
lean-ctx terse ultra        # maximum compression
lean-ctx terse off          # disable terse agent

Token Reports

Generate detailed token usage reports for analysis and cost tracking.

lean-ctx token-report [flags]

Display a comprehensive token usage report for the current or specified project. Also available as lean-ctx report-tokens (alias).

lean-ctx token-report                          # current session summary
lean-ctx token-report --period=week            # weekly report
lean-ctx token-report --by-tool --period=month # monthly per-tool breakdown
lean-ctx report-tokens --json > report.json    # alias, JSON export

Cache Management

Manage the lean-ctx content cache that accelerates repeated reads and avoids redundant compression.

lean-ctx cache <subcommand> [flags]

lean-ctx cache status                          # cache stats
lean-ctx cache clear                           # purge entire cache
lean-ctx cache invalidate "src/**/*.rs"        # invalidate Rust files
lean-ctx cache reset --project=~/my-app        # reset for one project

Gotchas

Manage known gotchas - common pitfalls, edge cases, and warnings that lean-ctx tracks across your projects. Also available as lean-ctx bugs (alias).

lean-ctx gotchas [list|add|remove|clear]

lean-ctx gotchas list
lean-ctx gotchas add "ctx_shell timeout on M1 with Docker Rosetta"
lean-ctx gotchas remove 3
lean-ctx bugs list            # alias for gotchas list
lean-ctx bugs clear

Buddy

The Buddy (also called Pet) is an interactive companion feature that provides contextual tips, encouragement, and session insights. Purely cosmetic and opt-in.

lean-ctx buddy [status|on|off|name <name>]

lean-ctx buddy status          # check buddy state
lean-ctx buddy on              # enable buddy
lean-ctx buddy name Ferris     # name your buddy
lean-ctx pet off               # alias - disable buddy

Context Packages

Crie, gerencie e compartilhe context packages portáteis que agrupam conhecimento, dados de grafo, descobertas de sessão e armadilhas em arquivos versionados.

lean-ctx pack create --name <name> [--layers <layers>]

Create a context package from the current project. Layers default to all available (knowledge,graph,session,patterns,gotchas).

lean-ctx pack create --name my-pkg
lean-ctx pack create --name api-knowledge --layers knowledge,gotchas
lean-ctx pack create --name full-snapshot --version 2.0.0

lean-ctx pack list

List all installed packages with version and auto-load status.

lean-ctx pack list

lean-ctx pack info <name>

Show detailed metadata, layers, stats, and integrity hash for a package.

lean-ctx pack info my-pkg

lean-ctx pack export <name> [-o <file>]

Export a package to a portable .lctxpkg file. Default output is <name>.lctxpkg.

lean-ctx pack export my-pkg
lean-ctx pack export my-pkg -o shared/my-pkg.lctxpkg

lean-ctx pack import <file>

Import a package from a .lctxpkg file. Verifies SHA-256 integrity before installing.

lean-ctx pack import my-pkg.lctxpkg

lean-ctx pack install <name>

Merge a package's context into the current project — knowledge facts, graph nodes, and gotchas.

lean-ctx pack install my-pkg

lean-ctx pack remove <name>

Remove a package from the local registry.

lean-ctx pack remove my-pkg

lean-ctx pack auto-load <name> <on|off>

Enable or disable auto-loading. When enabled, the package is merged into the project context automatically when ctx_overview runs at session start.

lean-ctx pack auto-load my-pkg on
lean-ctx pack auto-load my-pkg off

Instructions

Manually retrieve MCP server instructions. Useful in headless or non-interactive environments where the MCP handshake does not automatically deliver instructions.

lean-ctx instructions [flags] v3.3.x

lean-ctx instructions                   # print formatted instructions
lean-ctx instructions --raw             # raw text for piping
lean-ctx instructions --json            # JSON with metadata
lean-ctx instructions --inject          # inject into running session

This is particularly useful when integrating lean-ctx into CI/CD pipelines or custom agent frameworks that don't support the MCP instructions handshake natively.