cortex

Un maillage reverie, c’est un démon, un magasin de mémoire et un ensemble mouvant de sessions d’agents qui travaillent réellement sur de vrais dépôts. cortex est la console unique depuis laquelle vous le pilotez — démarrer le maillage, observer ce qu’il fait, contrôler ce qu’il a le droit de faire, puis le démonter. Un seul binaire, une seule surface, à chaque jalon.

Ce qu’est cortex

cortex est la console opérateur du maillage reverie et de la surface HTTP reveried. Là où reverie décide ce qu’un agent doit retenir, cortex est la façon dont un humain — ou un agent superviseur — voit et dirige les agents eux-mêmes : un CLI unique qui dialogue avec reveried en HTTP et gère les sessions locales via tmux et les worktrees git. Il s’appelait meshctl lors des premiers jalons ; la capacité a dépassé celle d’« un CLI de contrôle » pour devenir la console depuis laquelle tout le système est opéré, et le nom a suivi.

La surface

cortex s’organise autour d’une poignée de verbes sur le même maillage :

• cortex init — mise en route initiale : établir la connexion au démon et l’état local du maillage.
• cortex sessions up / down — créer et récupérer les sessions d’agents (chacune avec son worktree git et son panneau tmux), l’unité de travail du maillage.
• cortex dash — le TUI en direct : rôles, sessions, santé et activité dans un seul panneau.
• cortex gate — la barrière opérateur : faire remonter ce qui attend une décision humaine (une fusion, une action irréversible) et l’approuver ou la retenir.
• cortex health — une lecture rapide de la vivacité du démon et du maillage ; le même signal que consomment les sondes externes.
• cortex dream trigger — déclencher le cycle de consolidation hors ligne que reverie exécute sur sa mémoire (le « rêve » du démon).
• inspection par sous-système — dérive, graphe, nœuds, planificateur, rôles : lire l’état interne du maillage sans s’attacher à une session.

Tout passe par un seul endroit. Le CLI est un client HTTP léger vers reveried, plus la gestion des sessions locales — les mêmes commandes pilotent donc un maillage local ou distant, et le démon reste la source de vérité unique.

Utiliser cortex

cortex est livré dans la même installation en une commande que le reste de reverie :

git clone [email protected]:cerebral-work/reverie.git
cd reverie
scripts/install-reverie.sh   # compile reveried, cortex, reverie-bench → ~/.local/bin

Une session, de bout en bout :

cortex init                  # une seule fois : établir la connexion au démon
cortex health                # vérifier que reveried répond
cortex sessions up <rôle>     # créer une session d'agent (worktree + tmux)
cortex dash                  # observer le maillage en direct
cortex gate                  # approuver ce qui vous attend
cortex sessions down <id>     # la récupérer une fois terminée

Le modèle mental : reveried est le démon et la surface HTTP, reverie est la mémoire qu’il gère, et cortex est la console depuis laquelle vous opérez les deux. Vous parlez rarement au démon directement — cortex est la jointure.

Comment il s’articule avec reverie

reverie et cortex sont deux moitiés d’un même système. reverie est la couche mémoire — stockage conscient du placement, consolidation hors ligne, le pari que l’échec d’un agent est un problème de contexte et non un problème de modèle. cortex est la couche de contrôle — la surface opérateur sur le maillage d’agents qui utilisent cette mémoire. reverie répond à « que doit savoir cet agent ? » ; cortex répond à « que font ces agents, et que suis-je en train de les laisser faire ? ». Ils sont livrés ensemble et versionnés ensemble.

Ce qu’il n’est pas

• Pas un produit distinct. cortex est fourni avec reverie et suit ses versions ; il n’existe pas de cortex autonome à installer séparément.
• Pas un orchestrateur CI/CD. cortex pilote des sessions d’agents interactives et le démon reverie — ce n’est pas un exécuteur de pipelines et il ne remplace pas votre système de build.
• Pas un contrôleur autonome. La barrière est délibérée : les actions irréversibles et tournées vers l’extérieur s’arrêtent devant un humain. cortex fait remonter les décisions ; il ne prend pas à votre place celles qui comptent.

Statut

Propriétaire, fourni avec reverie. Copyright © 2026 Christian M. Todie / cerebral.work — tous droits réservés. Versionné avec reverie (actuellement v0.13.0). Cette page suit la surface pendant que reverie et cortex avancent vers le jalon v1.0 — les commandes et les options bougeront d’ici là. Pour une licence commerciale, un usage embarqué ou un accès d’évaluation : [email protected].