Guida

Installa e collega

Memo collega Claude Code e Codex sul tuo computer al tuo grafo sul nostro server. Basta un comando per computer.

Prima di iniziare

macOS, Linux o Windows con WSL. Windows nativo non è supportato.
python3 e curl su quel computer.
Claude Code, Codex o entrambi, con accesso tramite il tuo piano.
Un account Memo. Crealo se non ce l'hai.

Installazione

1. Ottieni la riga di installazione

Apri Account e premi Collega un computer. Ricevi una riga con un codice monouso. Il codice vale una sola volta e scade dopo 15 minuti.

2. Incollala e conferma

Incolla la riga in un terminale del computer da collegare, oppure in Claude Code o Codex aperti su quel computer. Ha questo aspetto, con il tuo codice:

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

Poi basta confermare. Il terminale chiede una volta: Continue? [Y/n]. Claude Code o Codex chiedono di eseguire il comando. Memo funziona dalla tua prossima sessione di Claude Code o Codex.

L'installer collega questo computer al tuo account e gli dà una chiave sua. Ogni file che scarica è elencato con il suo checksum SHA-256 in /kit/SHA256SUMS.

Aggiornamenti

Quando cambiano gli hook o le istruzioni di Memo, il tuo agente te lo dice in una riga e chiede. Se dici sì, installa l'aggiornamento. Puoi anche eseguirlo tu:

~/.memo/bin/memo update

L'aggiornamento mantiene la chiave di questo computer e sostituisce solo i file di Memo. La nuova versione funziona dalla sessione successiva.

Se memo update non funziona su un'installazione più vecchia, esegui invece questo, una volta sola:

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

Collega una sessione

Avvia Claude Code o Codex come al solito e chiedigli di collegarsi a Memo. In Claude Code scrivi /memo; in Codex scrivi $memo.

La sessione si registra come ramo, riceve il suo passaporto e inizia a scrivere i suoi passi sulla mappa. Apri il pannello per seguirla e impostare il passaporto.

Il passaporto viene prima di tutto. Gli agenti lo leggono a ogni turno. Dove dice no, il ramo prepara il lavoro e te lo chiede nella casella In arrivo.

Cosa cambia l'installer

Dove	Cosa
`~/.memo/config.json`	Il tuo indirizzo Memo, il nome del proprietario, il fuso orario e la versione del kit.
`~/.memo/token`	La chiave di questo computer. Solo il tuo utente può leggere il file e nessuno strumento di Memo la mostra.
`~/.memo/bin/memo`	Il comando `memo` che i tuoi agenti usano per leggere e scrivere il grafo.
`~/.memo/memo-hook.py`	L'hook che Claude Code e Codex eseguono agli eventi della sessione.
`~/.claude/settings.json`	Gli hook di Memo per Claude Code e il permesso di eseguire il comando memo e gli strumenti MCP di Memo senza chiedere ogni volta. Le altre impostazioni restano come sono.
`~/.codex/hooks.json`	Gli hook di Memo per Codex.
`~/.claude/skills/memo/` `~/.codex/skills/memo/`	La skill memo: come una sessione lavora con il suo ramo.
`~/.claude/CLAUDE.md` `~/.codex/AGENTS.md`	Un breve blocco Memo tra due marcatori; il file di Codex solo se Codex è installato. Il resto di ogni file resta com'è.
Server MCP di Claude Code, ambito utente	Un server chiamato `memo`, aggiunto solo se `claude` è nel tuo PATH.

MCP

Se claude è nel tuo PATH, l'installer lo esegue per te, con la chiave di questo computer al posto del segnaposto:

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

La chiave va direttamente a Claude Code e non appare sullo schermo. Per Codex, l'installer mostra l'impostazione da aggiungere a mano.

Strumenti che ricevono i tuoi agenti:

Strumento	Cosa fa
`memo_list`	Elenca i tuoi rami.
`memo_brief`	Una breve sintesi di un ramo.
`memo_show`	Un ramo per intero o uno dei suoi nodi.
`memo_register`	Crea un ramo.
`memo_apply`	Scrive le modifiche nei nodi di un ramo.
`memo_pending_answers`	Le tue risposte che il ramo non ha ancora ricevuto.
`memo_log`	La cronologia delle modifiche del ramo.

Il comando memo

Gli agenti raggiungono il grafo anche tramite ~/.memo/bin/memo. Puoi usarlo anche tu:

~/.memo/bin/memo list

Quando qualcosa non va, ti dice cosa fare in una riga:

La chiave non viene accettata, per esempio perché il computer è stato revocato: ottieni un nuovo codice nella pagina Account ed esegui di nuovo l'installer.
Il piano non è attivo: abbonati nella pagina Account. Nel frattempo il pannello continua a funzionare.

Scollega un computer

Nella pagina Account, premi Revoca accanto al computer. La sua chiave smette subito di funzionare. Il tuo grafo e gli altri computer non ne risentono.

Disinstallazione

Per rimuovere i file e le impostazioni di Memo da un computer, scarica di nuovo l'installer ed eseguilo con --uninstall:

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

Rimuove solo il blocco Memo da CLAUDE.md e AGENTS.md e ripristina le tue impostazioni dai backup creati durante l'installazione.

Se poi Claude Code elenca ancora il server MCP memo, rimuovilo:

claude mcp remove --scope user memo

Poi revoca il computer nella pagina Account, così la sua chiave smette di funzionare.