docs

Un dépôt, un installateur, deux surfaces. C’est ici que vous passez d’une machine vierge à un maillage reverie en fonctionnement — le démon mémoire démarré, la console cortex dans votre PATH, et un modèle mental pour savoir quelle pièce fait quoi.

Le modèle mental

reverie est livré comme un dépôt unique qui compile trois choses qui vous intéressent. Elles sont faciles à distinguer une fois qu’on sait à quelle question chacune répond :

• reveried — le démon. Le processus de longue durée qui détient le magasin de mémoire et le sert en HTTP sur :7437. Il répond à « que doit savoir cet agent ? » et exécute le cycle de consolidation hors ligne (le « rêve ») sur ce qu’il a stocké.
• reverie — la couche mémoire que le démon gère : stockage conscient du placement, consolidation, le pari que l’échec d’un agent est un problème de contexte et non un problème de modèle. Le démon, c’est la façon dont elle tourne ; reverie, c’est ce qu’elle est.
• cortex — la console opérateur. Un CLI unique qui dialogue avec reveried en HTTP et gère les sessions d’agents locales via tmux et les worktrees git. Il répond à « que font ces agents, et que suis-je en train de les laisser faire ? »

La jointure : vous parlez rarement à reveried directement. cortex est la surface depuis laquelle vous pilotez le démon et le maillage. reverie décide ce qu’un agent retient ; cortex dirige les agents qui l’utilisent. Ils vivent dans un seul dépôt et sont versionnés ensemble.

Installation en une commande

Le chemin par défaut vous donne un démon reveried en fonctionnement, le CLI cortex et le harnais de bench sur toute machine disposant d’une chaîne d’outils Rust — environ cinq minutes sur une machine vierge :

git clone [email protected]:cerebral-work/reverie.git
cd reverie
scripts/install-reverie.sh

Ce script unique :

• Vérifie la présence de cargo et rustc, puis compile l’espace de travail avec cargo build --release --workspace --all-features.
• Copie les binaires produits — reveried, cortex, reverie-bench, reverie-tracee — dans ~/.local/bin/.
• Sonde Redis sur 127.0.0.1:6379 (simple avertissement s’il est absent — le démon démarre quand même et se rabat sur le système de fichiers).
• Installe l’unité systemd utilisateur dans ~/.config/systemd/user/reveried.service et la démarre.
• Interroge /health sur :7437 et sort en erreur si le démon ne démarre pas.

Rien n’est écrit hors de $HOME et aucun sudo n’est utilisé. Le script est idempotent — pour mettre à jour, faites git pull et relancez-le : il arrête le démon, remplace le binaire, redémarre et revérifie /health.

Démarrage rapide

Une fois le démon installé et démarré, tout le reste passe par cortex. Une première session, de bout en bout :

cortex init                 # démarrage à froid du maillage : vérifier l'infra,
                            #   activer le reaper, relancer les workers canoniques,
                            #   créer le pool de fan-out ; préchauffer Ollama si présent
cortex health               # vérifier que reveried répond sur :7437
cortex sessions up          # démarrer tous les workers canoniques via mesh-spawn
cortex dash                 # observer le maillage en direct
cortex sessions down        # tout démonter (les worktrees modifiés sont préservés)

cortex health --json est la sonde unique couvrant démon et coordination — le même signal que consomment les moniteurs externes. Pour l’ensemble des verbes et options, cortex --help fait référence ; ce centre couvre le chemin d’entrée, pas chaque commande.

Pour aller plus loin

Les deux projets que cela installe, chacun avec sa page :

• reverie → — la couche mémoire : ce qu’elle décide qu’un agent doit retenir, où elle le place, et comment c’est validé.
• cortex → — la console opérateur : l’ensemble des verbes pour démarrer le maillage, l’inspecter et le contrôler.

Statut

Propriétaire, livré et versionné avec reverie (actuellement v0.13.0). Les commandes et les options bougeront jusqu’au jalon v1.0 — ce centre suit le chemin d’installation et de mise en route pendant que la surface se stabilise. Pour une licence commerciale, un usage embarqué ou un accès d’évaluation : [email protected].