Colony : Une couche de coordination locale qui réduit les jetons de transfert multi-agents de 30 000 à 400

Colony est une couche de coordination local-first pour les configurations de codage multi-agents. Elle se situe entre vos environnements d'exécution d'agents (Claude Code, Codex, Cursor, Gemini CLI, OpenCode) et un magasin SQLite local, réduisant les frais généraux de transfert d'environ 30 000 jetons à environ 400 jetons par fin de session.

Fonctionnalités clés

• Revendications avant modifications — Les agents revendiquent un fichier avant de le toucher ; les autres agents voient la revendication active et se retirent, évitant les conditions de course et les PR en double.
• Transferts compacts — À la fin de la session, Colony écrit un reçu structuré (lien PR, SHA de fusion, fichiers modifiés, résultats de vérification, état du nettoyage). Le prochain agent lit environ 400 jetons au lieu de rejouer environ 30 000.
• Diagnostics de santé — colony health détecte les échecs de coordination silencieux : revendications obsolètes, incohérences de pont de cycle de vie, écarts d'adoption plan-revendication.
• Mémoire persistante — Compressée au repos (compression de prose d'environ 70 %, parfait pour les chemins/code/commandes). Interrogeable via FTS5.

Ce qu'il n'est pas

• Pas un plan de contrôle hébergé — local-first par défaut, les données ne quittent jamais le disque.
• Pas un exécuteur d'agents — Codex, Claude, Cursor exécutent toujours le travail.
• Pas une orchestration — stigmergique : les agents laissent des traces, les utiles sont renforcées, les obsolètes s'évaporent.

Format du reçu de transfert

Lorsqu'une session se termine, les agents renvoient une réponse structurée avec le lien PR, le SHA de fusion, les fichiers modifiés, les résultats de vérification et l'état du nettoyage de l'arborescence de travail. Colony le capture comme une observation ; le prochain agent lit au lieu de redériver le contexte. mcp_metrics enregistre le coût.

Installation

npm install -g /colony-cli
colony install --ide codex
colony health

Nécessite Node 20+. Licence MIT. Toutes les données stockées dans ~/.colony/data.db.

Améliorations à venir

L'auteur travaille sur la résolution automatique des conflits de revendication sur le même fichier et une commande colony heal --apply qui exécute le plan de correction au lieu de simplement l'afficher.