Doku

Installieren und verbinden

Memo verbindet Claude Code und Codex auf deinem Rechner mit deinem Graphen auf unserem Server. Dafür reicht ein Befehl pro Rechner.

Bevor du anfängst

macOS, Linux oder Windows mit WSL. Windows ohne WSL wird nicht unterstützt.
python3 und curl auf diesem Rechner.
Claude Code, Codex oder beides, angemeldet mit deinem eigenen Abo.
Ein Memo-Konto. Erstelle eins, falls du noch keins hast.

Installation

1. Installationszeile holen

Öffne Konto und drück auf Rechner verbinden. Du bekommst eine Zeile mit einem Einmalcode. Der Code gilt einmal und läuft nach 15 Minuten ab.

2. Einfügen und bestätigen

Füge die Zeile auf dem Rechner, den du verbinden willst, in ein Terminal ein oder in Claude Code oder Codex, das dort läuft. Sie sieht so aus, mit deinem eigenen Code:

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

Dann nur noch bestätigen. Ein Terminal fragt einmal: Continue? [Y/n]. Claude Code oder Codex fragt, ob es den Befehl ausführen darf. Memo arbeitet ab deiner nächsten Sitzung in Claude Code oder Codex.

Der Installer verbindet diesen Rechner mit deinem Konto und gibt ihm einen eigenen Schlüssel. Jede Datei, die er herunterlädt, steht mit ihrer SHA-256-Prüfsumme unter /kit/SHA256SUMS.

Updates

Ändern sich die Hooks oder Anweisungen von Memo, sagt dir dein Agent das in einer Zeile und fragt nach. Sag ja, und er installiert das Update. Du kannst es auch selbst ausführen:

~/.memo/bin/memo update

Das Update behält den Schlüssel dieses Rechners und ersetzt nur die eigenen Dateien von Memo. Die neue Version gilt ab der nächsten Sitzung.

Wenn memo update bei einer älteren Installation nicht funktioniert, führ stattdessen einmal das hier aus:

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

Sitzung verbinden

Starte Claude Code oder Codex wie gewohnt und bitte es, sich mit Memo zu verbinden. Gib in Claude Code /memo ein, in Codex $memo.

Die Sitzung meldet sich als Zweig an, bekommt ihren Ausweis und schreibt ihre Schritte auf die Karte. Öffne das Pult, um ihr zuzusehen und den Ausweis einzustellen.

Der Ausweis hat Vorrang. Agenten lesen ihn bei jedem Zug. Wo er nein sagt, bereitet der Zweig die Arbeit vor und fragt dich im Posteingang.

Was der Installer ändert

Wo	Was
`~/.memo/config.json`	Memo-Adresse, Name des Inhabers, Zeitzone und Kit-Version.
`~/.memo/token`	Der Schlüssel dieses Rechners. Nur dein Benutzer kann die Datei lesen, und kein Memo-Werkzeug gibt ihn aus.
`~/.memo/bin/memo`	Der Befehl `memo`, mit dem deine Agenten den Graphen lesen und schreiben.
`~/.memo/memo-hook.py`	Der Hook, den Claude Code und Codex bei Sitzungsereignissen ausführen.
`~/.claude/settings.json`	Memo-Hooks für Claude Code und die Erlaubnis, den Befehl memo und die MCP-Werkzeuge von Memo auszuführen, ohne jedes Mal zu fragen. Deine übrigen Einstellungen bleiben, wie sie sind.
`~/.codex/hooks.json`	Memo-Hooks für Codex.
`~/.claude/skills/memo/` `~/.codex/skills/memo/`	Der Skill memo: wie eine Sitzung mit ihrem Zweig arbeitet.
`~/.claude/CLAUDE.md` `~/.codex/AGENTS.md`	Ein kurzer Memo-Block zwischen Markierungen; die Codex-Datei nur, wenn Codex installiert ist. Der Rest jeder Datei bleibt, wie er ist.
MCP-Server von Claude Code, Benutzerebene	Ein Server namens `memo`, nur hinzugefügt, wenn `claude` in deinem PATH liegt.

MCP

Liegt claude in deinem PATH, führt der Installer das für dich aus, mit dem Schlüssel dieses Rechners anstelle des Platzhalters:

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

Der Schlüssel geht direkt an Claude Code und erscheint nicht auf dem Bildschirm. Für Codex gibt der Installer die Einstellung aus, die du selbst hinzufügst.

Werkzeuge für deine Agenten:

Werkzeug	Was es tut
`memo_list`	Listet deine Zweige auf.
`memo_brief`	Eine kurze Zusammenfassung eines Zweigs.
`memo_show`	Ein Zweig vollständig oder einer seiner Knoten.
`memo_register`	Legt einen Zweig an.
`memo_apply`	Schreibt Änderungen in die Knoten eines Zweigs.
`memo_pending_answers`	Deine Antworten, die der Zweig noch nicht übernommen hat.
`memo_log`	Der Änderungsverlauf des Zweigs.

Der Befehl memo

Agenten erreichen den Graphen auch über ~/.memo/bin/memo. Du kannst ihn ebenfalls nutzen:

~/.memo/bin/memo list

Wenn etwas nicht stimmt, sagt er in einer Zeile, was zu tun ist:

Der Schlüssel wird nicht angenommen, etwa weil der Rechner widerrufen wurde: Hol dir unter Konto einen neuen Code und führ den Installer erneut aus.
Der Tarif ist inaktiv: Abonniere unter Konto. Das Pult funktioniert in der Zwischenzeit weiter.

Rechner trennen

Drück unter Konto neben dem Rechner auf Widerrufen. Sein Schlüssel funktioniert sofort nicht mehr. Dein Graph und deine anderen Rechner bleiben unberührt.

Deinstallation

Um die Dateien und Einstellungen von Memo von einem Rechner zu entfernen, lade den Installer erneut herunter und führ ihn mit --uninstall aus:

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

Er entfernt nur den Memo-Block aus CLAUDE.md und AGENTS.md und stellt deine Einstellungen aus den Backups wieder her, die er bei der Installation angelegt hat.

Zeigt Claude Code danach noch den MCP-Server memo an, entferne ihn:

claude mcp remove --scope user memo

Widerrufe dann den Rechner unter Konto, damit sein Schlüssel nicht mehr funktioniert.