Docs

Installer et connecter

Memo relie Claude Code et Codex sur votre ordinateur à votre graphe sur notre serveur. Il suffit d’une commande par ordinateur.

Avant de commencer

macOS, Linux ou Windows avec WSL. Windows natif n’est pas pris en charge.
python3 et curl sur cet ordinateur.
Claude Code, Codex ou les deux, connectés avec votre propre abonnement.
Un compte Memo. Créez-en un si vous n’en avez pas.

Installation

1. Obtenez votre ligne d’installation

Ouvrez la page Compte et appuyez sur Connecter un ordinateur. Vous obtenez une ligne avec un code à usage unique. Le code ne sert qu’une fois et expire au bout de 15 minutes.

2. Collez-la, puis confirmez

Collez la ligne dans un terminal de l’ordinateur à connecter, ou dans Claude Code ou Codex qui tourne dessus. Elle ressemble à ceci, avec votre propre code :

curl -fsSL https://memo.example/kit/install.py -o memo-install.py && python3 memo-install.py --server https://memo.example --code ABCD-EFGH

Puis confirmez, c’est tout. Un terminal demande une fois : Continue? [Y/n]. Claude Code ou Codex demande à exécuter la commande. Memo fonctionne dès votre prochaine session Claude Code ou Codex.

L’installateur relie cet ordinateur à votre compte et lui donne sa propre clé. Chaque fichier qu’il télécharge figure avec sa somme de contrôle SHA-256 dans /kit/SHA256SUMS.

Mises à jour

Quand les hooks ou les instructions de Memo changent, votre agent vous le signale en une ligne et vous demande votre accord. Dites oui, et il installe la mise à jour. Vous pouvez aussi la lancer vous-même :

~/.memo/bin/memo update

La mise à jour garde la clé de cet ordinateur et ne remplace que les fichiers de Memo. La nouvelle version s’applique dès la prochaine session.

Si memo update ne fonctionne pas sur une ancienne installation, lancez plutôt ceci une fois :

curl -fsSL https://memo.example/kit/install.py -o memo-install.py && python3 memo-install.py --update

Connecter une session

Lancez Claude Code ou Codex comme d’habitude et demandez-lui de se connecter à Memo. Dans Claude Code, tapez /memo ; dans Codex, tapez $memo.

La session s’enregistre comme branche, reçoit son passeport et commence à écrire ses étapes sur la carte. Ouvrez le panneau pour la suivre et régler le passeport.

Le passeport passe avant tout. Les agents le lisent à chaque tour. Là où il dit non, la branche prépare le travail et vous pose la question dans la boîte de réception.

Ce que change l’installateur

Où	Quoi
`~/.memo/config.json`	Votre adresse Memo, le nom du propriétaire, le fuseau horaire et la version du kit.
`~/.memo/token`	La clé de cet ordinateur. Seul votre compte utilisateur peut lire le fichier, et aucun outil Memo ne l’affiche.
`~/.memo/bin/memo`	La commande `memo` que vos agents utilisent pour lire et écrire le graphe.
`~/.memo/memo-hook.py`	Le hook que Claude Code et Codex exécutent aux événements de session.
`~/.claude/settings.json`	Hooks Memo pour Claude Code, et l’autorisation de lancer la commande memo et les outils MCP de Memo sans demander à chaque fois. Vos autres réglages ne changent pas.
`~/.codex/hooks.json`	Hooks Memo pour Codex.
`~/.claude/skills/memo/` `~/.codex/skills/memo/`	Le skill memo : comment une session travaille avec sa branche.
`~/.claude/CLAUDE.md` `~/.codex/AGENTS.md`	Un court bloc Memo entre des marqueurs ; le fichier Codex seulement si Codex est installé. Le reste de chaque fichier ne change pas.
Serveurs MCP de Claude Code, portée utilisateur	Un serveur nommé `memo`, ajouté seulement si `claude` est dans votre PATH.

MCP

Si claude est dans votre PATH, l’installateur l’exécute pour vous, avec la clé de cet ordinateur à la place de l’espace réservé :

claude mcp add --scope user --transport http memo https://memo.example/mcp --header "Authorization: Bearer <this computer's key>"

La clé va directement à Claude Code et ne s’affiche pas à l’écran. Pour Codex, l’installateur affiche le réglage à ajouter vous-même.

Outils dont disposent vos agents :

Outil	Ce qu’il fait
`memo_list`	Liste vos branches.
`memo_brief`	Un bref résumé d’une branche.
`memo_show`	Une branche entière, ou l’un de ses nœuds.
`memo_register`	Crée une branche.
`memo_apply`	Écrit les modifications dans les nœuds d’une branche.
`memo_pending_answers`	Vos réponses que la branche n’a pas encore récupérées.
`memo_log`	L’historique des modifications de la branche.

La commande memo

Les agents accèdent aussi au graphe via ~/.memo/bin/memo. Vous pouvez l’utiliser vous aussi :

~/.memo/bin/memo list

En cas de problème, il indique quoi faire en une ligne :

La clé n’est pas acceptée, par exemple parce que l’ordinateur a été révoqué : obtenez un nouveau code sur la page Compte et relancez l’installateur.
La formule est inactive : abonnez-vous sur la page Compte. En attendant, le panneau continue de fonctionner.

Déconnecter un ordinateur

Sur la page Compte, appuyez sur Révoquer à côté de l’ordinateur. Sa clé cesse aussitôt de fonctionner. Votre graphe et vos autres ordinateurs ne sont pas touchés.

Désinstallation

Pour retirer les fichiers et réglages de Memo d’un ordinateur, téléchargez à nouveau l’installateur et lancez-le avec --uninstall :

curl -fsSL https://memo.example/kit/install.py -o memo-install.py && python3 memo-install.py --uninstall

Il supprime seulement le bloc Memo de CLAUDE.md et AGENTS.md et restaure vos réglages à partir des sauvegardes faites à l’installation.

Si Claude Code affiche encore le serveur MCP memo ensuite, supprimez-le :

claude mcp remove --scope user memo

Révoquez ensuite l’ordinateur sur la page Compte pour que sa clé cesse de fonctionner.