README_pt.md
rtk filtra e comprime saídas de comandos antes de chegarem ao contexto do seu LLM. Binário Rust único, zero dependências, overhead inferior a 10ms.
O RTK intercepta comandos de shell e comprime a saída antes que seu agente a leia.
| Operação | O que o RTK faz com a saída |
|---|---|
ls / tree | Formato de árvore com contagem de arquivos em vez de uma linha por entrada |
cat / read | Leitura inteligente: assinaturas e estrutura em vez de corpos completos |
grep / rg | Trunca linhas longas, agrupa correspondências por arquivo |
git status | Formato stat compacto, agrupado por estado |
git diff | Contexto reduzido, cabeçalhos removidos |
git log | Apenas hash, autor e assunto |
git add/commit/push | Linha de confirmação em vez da saída de progresso completa |
cargo test / npm test | Apenas falhas, testes aprovados reduzidos a um contador |
ruff check | Agrupado por regra e arquivo |
pytest | Apenas falhas, traceback encurtado |
go test | NDJSON parseado, apenas falhas |
docker ps | Apenas campos essenciais |
O RTK corta até 90% da saída bash que seu agente lê. É isso que o RTK mede, e não é a mesma coisa que reduzir sua fatura em 90%.
A saída bash é um dos contribuintes para os tokens de entrada, ao lado do seu prompt, do prompt de sistema e do histórico da conversa. Os tokens de entrada são, por sua vez, apenas parte da fatura, que também conta os tokens de saída. A redução se dilui a cada etapa.
As contagens de tokens que o RTK reporta são estimadas como bytes / 4: o RTK não embarca nenhum tokenizador, portanto os percentuais são confiáveis, mas os números absolutos de tokens são aproximados.
Explicação completa: Como funciona a economia do RTK
brew install rtk
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
cargo install --git https://github.com/rtk-ai/rtk
rtk --version # Deve exibir "rtk 0.28.2"
rtk gain # Deve exibir estatísticas de economia
# 1. Instalar hook para Claude Code (recomendado)
rtk init --global
# 2. Reiniciar Claude Code, depois testar
git status # Reescrito automaticamente para rtk git status
Sem rtk: Com rtk:
Claude --git status--> shell --> git Claude --git status--> RTK --> git
^ | ^ | |
| ~2,000 tokens (bruto) | | ~200 tokens | filtro |
+-----------------------------------+ +------- (filtrado) ---+----------+
Quatro estratégias:
Os percentuais abaixo são reduções de bytes da saída bash, medidas com o estimador
bytes / 4do RTK. Veja Como funciona a economia.
rtk ls . # Árvore de diretórios otimizada
rtk read file.rs # Leitura inteligente
rtk find "*.rs" . # Resultados compactos
rtk grep "pattern" . # Busca agrupada por arquivo
rtk git status # Status compacto
rtk git log -n 10 # Commits em uma linha
rtk git diff # Diff condensado
rtk git push # -> "ok main"
rtk jest # Jest compacto
rtk vitest # Vitest compacto
rtk pytest # Tests Python (-90%)
rtk go test # Tests Go (-90%)
rtk cargo test # Tests Rust (-90%)
rtk test <cmd> # Só falhas (-90%)
rtk lint # ESLint agrupado por regra
rtk tsc # Erros TypeScript agrupados
rtk cargo build # Build Cargo (-80%)
rtk ruff check # Lint Python (-80%)
rtk gain # Estatísticas de economia
rtk gain --graph # Gráfico ASCII (30 dias)
rtk discover # Descobrir economias perdidas
Contribuições são bem-vindas. Abra uma issue ou PR no GitHub.
Junte-se à comunidade no Discord.
Apache License 2.0 - veja LICENSE para detalhes.
Veja DISCLAIMER.md.