Dokumentasi

Instal dan hubungkan

Memo menghubungkan Claude Code dan Codex di komputer Anda ke graf Anda di server kami. Cukup satu perintah per komputer.

Sebelum mulai

macOS, Linux, atau Windows dengan WSL. Windows tanpa WSL tidak didukung.
python3 dan curl di komputer tersebut.
Claude Code, Codex, atau keduanya, masuk dengan paket Anda sendiri.
Akun Memo. Buat akun jika belum punya.

Instal

1. Ambil baris instalasi Anda

Buka Akun dan tekan Hubungkan komputer. Anda mendapat satu baris dengan kode sekali pakai. Kode hanya berlaku sekali dan kedaluwarsa setelah 15 menit.

2. Tempel, lalu konfirmasi

Tempel baris itu ke terminal di komputer yang ingin Anda hubungkan, atau ke Claude Code atau Codex yang berjalan di sana. Bentuknya seperti ini, dengan kode Anda sendiri:

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

Lalu cukup konfirmasi. Terminal bertanya sekali: Continue? [Y/n]. Claude Code atau Codex meminta izin menjalankan perintah. Memo berlaku mulai sesi Claude Code atau Codex berikutnya.

Penginstal menghubungkan komputer ini ke akun Anda dan memberinya kunci sendiri. Setiap file yang diunduhnya tercantum beserta checksum SHA-256 di /kit/SHA256SUMS.

Pembaruan

Saat hook atau instruksi Memo berubah, agen Anda memberi tahu dalam satu baris dan bertanya. Jawab ya, dan agen memasang pembaruannya. Anda juga bisa menjalankannya sendiri:

~/.memo/bin/memo update

Pembaruan mempertahankan kunci komputer ini dan hanya mengganti file milik Memo. Versi baru berlaku mulai sesi berikutnya.

Jika memo update tidak berjalan di instalasi lama, jalankan ini sekali sebagai gantinya:

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

Hubungkan sesi

Jalankan Claude Code atau Codex seperti biasa dan minta untuk terhubung ke Memo. Di Claude Code, ketik /memo; di Codex, ketik $memo.

Sesi terdaftar sebagai cabang, mendapat paspornya, dan mulai menulis langkahnya ke peta. Buka panel untuk memantaunya dan mengatur paspor.

Paspor yang utama. Agen membacanya di setiap giliran. Jika paspor tidak mengizinkan, cabang menyiapkan pekerjaan dan bertanya kepada Anda di kotak masuk.

Apa yang diubah penginstal

Lokasi	Isi
`~/.memo/config.json`	Alamat Memo Anda, nama pemilik, zona waktu, dan versi kit.
`~/.memo/token`	Kunci komputer ini. Hanya akun Anda di komputer ini yang bisa membaca file-nya, dan tidak ada alat Memo yang menampilkannya.
`~/.memo/bin/memo`	Perintah `memo` yang dipakai agen Anda untuk membaca dan menulis graf.
`~/.memo/memo-hook.py`	Hook yang dijalankan Claude Code dan Codex pada peristiwa sesi.
`~/.claude/settings.json`	Hook Memo untuk Claude Code, serta izin menjalankan perintah memo dan alat MCP Memo tanpa bertanya setiap kali. Pengaturan Anda yang lain tetap seperti semula.
`~/.codex/hooks.json`	Hook Memo untuk Codex.
`~/.claude/skills/memo/` `~/.codex/skills/memo/`	Skill memo: cara sesi bekerja dengan cabangnya.
`~/.claude/CLAUDE.md` `~/.codex/AGENTS.md`	Blok Memo singkat di antara penanda; file Codex hanya jika Codex terpasang. Isi file lainnya tetap seperti semula.
Server MCP Claude Code, cakupan pengguna	Server bernama `memo`, ditambahkan hanya jika `claude` ada di PATH Anda.

MCP

Jika claude ada di PATH Anda, penginstal menjalankan ini untuk Anda, dengan kunci komputer ini menggantikan placeholder:

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

Kunci langsung masuk ke Claude Code dan tidak ditampilkan di layar. Untuk Codex, penginstal menampilkan pengaturan yang perlu Anda tambahkan sendiri.

Alat yang didapat agen Anda:

Alat	Fungsinya
`memo_list`	Menampilkan daftar cabang Anda.
`memo_brief`	Ringkasan singkat satu cabang.
`memo_show`	Satu cabang lengkap, atau salah satu simpulnya.
`memo_register`	Membuat cabang.
`memo_apply`	Menulis perubahan ke simpul cabang.
`memo_pending_answers`	Jawaban Anda yang belum diambil cabang.
`memo_log`	Riwayat perubahan cabang.

Perintah memo

Agen juga mengakses graf lewat ~/.memo/bin/memo. Anda juga bisa memakainya:

~/.memo/bin/memo list

Jika ada masalah, perintah ini menyebutkan langkahnya dalam satu baris:

Kunci tidak diterima, misalnya karena komputer sudah dicabut: ambil kode baru di Akun dan jalankan penginstal lagi.
Paket tidak aktif: berlangganan di Akun. Sementara itu panel tetap berfungsi.

Putuskan komputer

Di Akun, tekan Cabut di samping komputer itu. Kuncinya langsung tidak berlaku. Graf Anda dan komputer lain tidak terpengaruh.

Hapus instalasi

Untuk menghapus file dan pengaturan Memo dari komputer, unduh lagi penginstal dan jalankan dengan --uninstall:

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

Penginstal hanya menghapus blok Memo dari CLAUDE.md dan AGENTS.md dan memulihkan pengaturan Anda dari cadangan yang dibuatnya saat instalasi.

Jika setelah itu Claude Code masih menampilkan server MCP memo, hapus server itu:

claude mcp remove --scope user memo

Lalu cabut komputer itu di Akun agar kuncinya tidak berlaku lagi.