Governor es un plugin de Claude Code que aborda la hinchazón de tokens y contexto más allá de la simple compresión de estilo. Reduce los tokens de salida, reduce archivos de memoria recurrentes como CLAUDE.md, filtra registros ruidosos de compilación/prueba y añade barreras de planificación para evitar la desviación del alcance. Se instala como un plugin de Claude Code, exponiendo un espacio de nombres de comandos /governor:*.

Inicio rápido

bash install.sh --force

Reinicia Claude Code y luego ejecuta:

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

Governor se inicia automáticamente en modo profesional compacto. Actívalo con /governor:on y desactívalo con /governor:off.

Benchmarks

Pequeños benchmarks locales con Sonnet (no interactivo, sin herramientas):

• Tokens de salida (tres prompts técnicos): Control promedio 989 tokens → Governor promedio 440 tokens (55.5% de ahorro). El estilo cavernícola da un 44.9% de ahorro.
• Compresión de memoria: Archivo de 1877 tokens → 838 tokens (55.4% de ahorro) con compresión media.
• Filtrado de salida de herramientas: Salida ruidosa sintética de pytest -vv de 54,314 tokens estimados → 1,726 tokens (96.8% bloqueado) con líneas de fallo preservadas.

Características clave

• Modo compacto siempre activo mediante hooks SessionStart y UserPromptSubmit.
• Compresión profesional de memoria: /governor:compress CLAUDE.md reescribe archivos verbosos preservando bloques de código, código en línea, rutas, URLs, encabezados, tablas, advertencias y variables de entorno. Un control de calidad rechaza compresiones con poco ahorro y restaura la copia de seguridad.
• Filtrado de salida de herramientas: Resume la salida ruidosa de Bash/pruebas/compilación pero preserva las señales de fallo.
• Registro de telemetría: /governor:status reporta tokens bloqueados, fallos, compactaciones.
• Guía de prompts: Sugerencias suaves para prompts vagos y amplios.
• Plan y guardián de desviación: /governor:plan crea un contrato de implementación; /governor:guard verifica los cambios actuales contra él.
• Fragmentos de reglas portátiles: Reglas de modo compacto incluidas para Codex, Gemini, Cursor, Windsurf y Cline.

Comandos

• /governor:on / /governor:off – Activar/desactivar compresión de respuesta
• /governor:status – Panel de uso y mapa de calor de desperdicio
• /governor:audit – Encontrar archivos de memoria/reglas hinchados
• /governor:compress CLAUDE.md – Comprimir archivos de memoria
• /governor:full – El próximo comando Bash devuelve la salida completa
• /governor:plan / /governor:guard – Gestión del alcance
• /governor:benchmark – Explicar resultados del benchmark

Instalación

# Desarrollo local
claude --plugin-dir .

Instalación local en una línea
bash install.sh --force
Desde el repositorio
gh repo clone 0xhimanshu/governor
cd governor
bash install.sh --force

Los usuarios intensivos de Claude Code deberían probar Governor si tienen problemas con la hinchazón del contexto, la desviación de tareas amplias o los registros ruidosos que consumen su cuota. Es una alternativa seria a los ahorradores de tokens basados solo en estilo.