Governor est un plugin Claude Code qui lutte contre le gonflement des tokens et du contexte au-delà d'une simple compression stylistique. Il réduit les tokens de sortie, compresse les fichiers mémoire récurrents comme CLAUDE.md, filtre les journaux de build/test bruyants et ajoute des garde-fous de planification pour éviter la dérive de périmètre. Il s'installe comme un plugin Claude Code, exposant un espace de noms de commandes /governor:*.

Démarrage rapide

bash install.sh --force

Redémarrez Claude Code, puis exécutez :

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

Governor se lance automatiquement en mode professionnel compact. Activez/désactivez avec /governor:on et /governor:off.

Benchmarks

Petits benchmarks locaux avec Sonnet (non interactif, sans outils) :

• Tokens de sortie (trois invites techniques) : Témoin 989 tokens en moyenne → Governor 440 tokens (55,5% d'économie). Le style préhistorique donne 44,9% d'économie.
• Compression mémoire : Fichier de 1877 tokens → 838 tokens (55,4% d'économie) avec compression moyenne.
• Filtrage de sortie d'outils : Sortie bruyante synthétique de pytest -vv de 54 314 tokens estimés → 1 726 tokens (96,8% bloqués) avec lignes d'échec conservées.

Fonctionnalités clés

• Mode compact toujours actif via les hooks SessionStart et UserPromptSubmit.
• Compression mémoire professionnelle : /governor:compress CLAUDE.md réécrit les fichiers verbeux tout en préservant les blocs de code, le code en ligne, les chemins, les URL, les titres, les tableaux, les avertissements et les variables d'environnement. Un contrôle qualité rejette les compressions à faible économie et restaure la sauvegarde.
• Filtrage des sorties d'outils : Résume les sorties bruyantes de Bash/test/build mais préserve les signaux d'échec.
• Registre de télémétrie : /governor:status rapporte les tokens bloqués, les échecs, les compactages.
• Guidance d'invite : Suggestions douces pour les invites vagues et larges.
• Garde-fou de planification et de dérive : /governor:plan crée un contrat d'implémentation ; /governor:guard vérifie les modifications actuelles par rapport à celui-ci.
• Extraits de règles portables : Règles de mode compact incluses pour Codex, Gemini, Cursor, Windsurf et Cline.

Commandes

• /governor:on / /governor:off – Activer/désactiver la compression des réponses
• /governor:status – Tableau de bord d'utilisation et carte de chaleur des déchets
• /governor:audit – Trouver les fichiers mémoire/règle gonflés
• /governor:compress CLAUDE.md – Compresser les fichiers mémoire
• /governor:full – La prochaine commande Bash renvoie la sortie complète
• /governor:plan / /governor:guard – Gestion du périmètre
• /governor:benchmark – Expliquer les résultats des benchmarks

Installation

# Développement local
claude --plugin-dir .

Installation locale en une ligne
bash install.sh --force
Depuis un dépôt
gh repo clone 0xhimanshu/governor
cd governor
bash install.sh --force

Les utilisateurs intensifs de Claude Code devraient essayer Governor s'ils luttent contre le gonflement du contexte, la dérive des tâches larges ou les journaux bruyants qui consomment leur quota. C'est une alternative sérieuse aux économiseurs de tokens stylistiques uniquement.