CodeGrid — manuel opérationnel de l'agent

CodeGrid exécute de nombreux agents de codage côte à côte sur un canvas 2D infini. Chaque volet est un processus (claude, codex, gemini, cursor-agent, grok, ou un shell) avec son propre répertoire de travail, sa branche git et un session_id stable. Le bus d'agents permet à n'importe quel volet de découvrir, lire et envoyer des messages à n'importe quel autre volet localement.

Cette skill est le point d'entrée parapluie. Deux références couvrent la surface complète :

Operating CodeGrid — le modèle mental (canvas / volet / workspace / agent / bus), les outils MCP (list_agents, read_pane, message_agent), l'API JSON-RPC du socket de contrôle (agent_list, agent_read, agent_send, open_folder, new_session, new_workspace), le schéma de lien profond codegrid://, et un playbook opérationnel avec recettes.
Agent-bus collaboration — le protocole read → message → read, identification des agents par rôle et session_id, patterns d'orchestration (délégation, review, pipeline, fan-out parallèle, monitoring, débat), étiquette et sécurité des périmètres, prévention des boucles/débordements, récupération après erreur, et exemples complets bout à bout.

Quand charger quelle référence

Tu es sur le point de…	Charge
Découvrir ce qui s'exécute, ouvrir un dossier, spawner une session, ou piloter CodeGrid de l'extérieur	`using-codegrid`
Confier du travail à / consulter / revoir avec un autre agent déjà en cours d'exécution dans CodeGrid	`codegrid-agent-bus`
Les deux	Charge `using-codegrid` en premier, puis `codegrid-agent-bus`

Quickstart (à l'intérieur d'un volet CodeGrid)

list_agents()                                  # découvrir les volets (session_id, rôle, statut)
read_pane(<session_id>)                        # voir ce qu'ils font — toujours sûr
message_agent(<session_id>, "[from <you>] <self-contained request>")
… attendre, puis read_pane(<session_id>) pour la réponse.

Quickstart (depuis l'extérieur de CodeGrid, ex. un autre outil)

SOCK="$(cat ~/.codegrid/socket-path 2>/dev/null || echo ~/.codegrid/socket)"
printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"agent_list"}' | nc -U "$SOCK"

# Ou deep-link l'app installée :
open "codegrid://open?path=/abs/path/to/repo&type=codex"
open "codegrid://new"

Install

installer la skill codegrid depuis https://github.com/BankrBot/skills/tree/main/codegrid

Source

La source de vérité canonique se trouve dans le repo CodeGrid sous skills/ (skills/using-codegrid/SKILL.md, skills/codegrid-agent-bus/SKILL.md). Ce fournisseur Bankr Skills est une copie publiée maintenue en sync.
Téléchargement d'app + docs complets : https://codegrid.app.
Token (Base) : 0x6B456E66524aEC1792013eF9DFE87e3F84311ba3 — voir https://codegrid.app/token.

Valeurs par défaut de sécurité qu'un agent doit respecter

Lire avant d'écrire. read_pane est gratuit ; ne message jamais un agent occupé.
Adresser par session_id, jamais par numéro de volet — les numéros de volets changent.
Être explicite sur le périmètre. Les autres agents peuvent être en mode YOLO/autonome et agiront sur tout ce que tu envoies. Dis « propose seulement, n'édite pas les fichiers » quand tu veux une analyse.
Un message, puis attendre. Plusieurs messages s'entrelacent dans la boîte d'entrée de la cible et la corrompent.
Borner les débats et ne pas spawner d'aides non bornées. Converger et signaler à l'utilisateur.
Rester local. Tout est IPC sur la même machine ; il n'y a pas de bus distant.

Guidance complète : voir les deux fichiers de référence.