Governor é um plugin do Claude Code que combate o inchaço de tokens e contexto além da simples compressão de estilo. Ele reduz tokens de saída, compacta arquivos de memória recorrentes como CLAUDE.md, filtra logs barulhentos de build/teste e adiciona proteções de planejamento para evitar desvios de escopo. Ele é instalado como um plugin do Claude Code, expondo um namespace de comandos /governor:*.

Início Rápido

bash install.sh --force

Reinicie o Claude Code e execute:

/governor:status
/governor:audit
/governor:compress CLAUDE.md

O Governor inicia automaticamente no modo profissional compacto. Alterne com /governor:on e /governor:off.

Benchmarks

Pequenos benchmarks locais com Sonnet (não interativo, sem ferramentas):

• Tokens de saída (três prompts técnicos): Controle médio de 989 tokens → Governor médio de 440 tokens (economia de 55,5%). Estilo 'caveman' dá economia de 44,9%.
• Compressão de memória: Arquivo de 1877 tokens → 838 tokens (economia de 55,4%) com compressão média.
• Filtragem de saída de ferramentas: Saída barulhenta sintética de pytest -vv com 54.314 tokens estimados → 1.726 tokens (96,8% bloqueados) com linhas de falha preservadas.

Principais Recursos

• Modo compacto sempre ativo via hooks SessionStart e UserPromptSubmit.
• Compressão profissional de memória: /governor:compress CLAUDE.md reescreve arquivos verbosos preservando blocos de código, código inline, caminhos, URLs, cabeçalhos, tabelas, avisos e variáveis de ambiente. Uma proteção de qualidade rejeita compressões com baixa economia e restaura o backup.
• Filtragem de saída de ferramentas: Resume saída barulhenta de Bash/teste/build, mas preserva sinais de falha.
• Registro de telemetria: /governor:status relata tokens bloqueados, falhas, compactações.
• Orientação de prompt: Sugestões suaves para prompts vagos e amplos.
• Proteção de plano e desvio: /governor:plan cria um contrato de implementação; /governor:guard verifica as mudanças atuais contra ele.
• Snippets de regras portáteis: Regras de modo compacto incluídas para Codex, Gemini, Cursor, Windsurf e Cline.

Comandos

• /governor:on / /governor:off – Ativar/desativar compressão de resposta
• /governor:status – Painel de uso e mapa de calor de desperdício
• /governor:audit – Encontrar arquivos de memória/regras inchados
• /governor:compress CLAUDE.md – Comprimir arquivos de memória
• /governor:full – Próximo comando Bash retorna saída completa
• /governor:plan / /governor:guard – Gerenciamento de escopo
• /governor:benchmark – Explicar resultados do benchmark

Instalação

# Desenvolvimento local
claude --plugin-dir .

Instalação local em uma linha
bash install.sh --force
Do repositório
gh repo clone 0xhimanshu/governor
cd governor
bash install.sh --force

Usuários pesados do Claude Code devem experimentar o Governor se enfrentarem inchaço de contexto, desvio de tarefa amplo ou logs barulhentos consumindo sua cota. É uma alternativa séria aos economizadores de token baseados apenas em estilo.