Документация
Установка и подключение
Memo связывает Claude Code и Codex на вашем компьютере с вашим графом на нашем сервере. Нужна одна команда на компьютер.
Перед началом
- macOS, Linux или Windows с WSL. Windows без WSL не поддерживается.
- python3 и curl на этом компьютере.
- Claude Code, Codex или оба: вы вошли в них со своей подпиской.
- Аккаунт Memo. Создайте его, если ещё нет.
Установка
1. Получите строку установки
Откройте страницу аккаунта и нажмите Подключить компьютер. Вы получите строку с одноразовым кодом. Код действует один раз и истекает через 15 минут.
2. Вставьте её и подтвердите
Вставьте строку в терминал на компьютере, который хотите подключить, или в запущенный на нём Claude Code или Codex. Она выглядит так, только с вашим кодом:
curl -fsSL https://memo.example/kit/install.py -o memo-install.py && python3 memo-install.py --server https://memo.example --code ABCD-EFGH
Затем просто подтвердите. Терминал один раз спросит: Continue? [Y/n]. Claude Code или Codex попросит разрешения запустить команду. Memo заработает со следующей сессии Claude Code или Codex.
Установщик привязывает этот компьютер к вашему аккаунту и выдаёт ему собственный ключ. Все скачиваемые файлы с контрольными суммами SHA-256 перечислены в /kit/SHA256SUMS.
Обновления
Когда хуки или инструкции Memo меняются, агент сообщает об этом одной строкой и спрашивает. Ответите «да» — и он поставит обновление. Можно запустить его и вручную:
~/.memo/bin/memo update
Обновление сохраняет ключ этого компьютера и заменяет только файлы самого Memo. Новая версия заработает со следующей сессии.
Если на старой установке memo update не срабатывает, вместо неё один раз запустите это:
curl -fsSL https://memo.example/kit/install.py -o memo-install.py && python3 memo-install.py --updateПодключение сессии
Запустите Claude Code или Codex как обычно и попросите подключиться к Memo. В Claude Code наберите /memo, в Codex — $memo.
Сессия регистрируется как ветка, получает паспорт и начинает записывать шаги на карту. Откройте панель, чтобы следить за ней и настроить паспорт.
Паспорт главнее всего. Агенты читают его на каждом ходу. Где он говорит «нет», ветка готовит работу и спрашивает вас во входящих.
Что меняет установщик
| Где | Что |
|---|---|
~/.memo/config.json | Адрес Memo, имя владельца, часовой пояс и версия комплекта. |
~/.memo/token | Ключ этого компьютера. Читать файл может только ваша учётная запись, и ни один инструмент Memo его не показывает. |
~/.memo/bin/memo | Команда memo, через которую агенты читают и пишут граф. |
~/.memo/memo-hook.py | Хук, который Claude Code и Codex запускают на события сессии. |
~/.claude/settings.json | Хуки Memo для Claude Code и разрешение запускать команду memo и MCP-инструменты Memo, не спрашивая каждый раз. Остальные настройки не меняются. |
~/.codex/hooks.json | Хуки Memo для Codex. |
~/.claude/skills/memo/~/.codex/skills/memo/ | Навык memo: как сессия работает со своей веткой. |
~/.claude/CLAUDE.md~/.codex/AGENTS.md | Короткий блок Memo между метками; файл Codex — только если Codex установлен. Остальное в каждом файле не меняется. |
| MCP-серверы Claude Code, область пользователя | Сервер с именем memo. Добавляется, только если claude есть в PATH. |
MCP
Если claude есть в PATH, установщик сам выполнит эту команду и подставит ключ этого компьютера вместо заглушки:
claude mcp add --scope user --transport http memo https://memo.example/mcp --header "Authorization: Bearer <this computer's key>"Ключ уходит прямо в Claude Code и на экран не выводится. Для Codex установщик покажет настройку, которую нужно добавить вручную.
Какие инструменты получают агенты:
| Инструмент | Что делает |
|---|---|
memo_list | Показывает ваши ветки. |
memo_brief | Краткая сводка одной ветки. |
memo_show | Одна ветка целиком или один её узел. |
memo_register | Создаёт ветку. |
memo_apply | Записывает изменения в узлы ветки. |
memo_pending_answers | Ваши ответы, которые ветка ещё не забрала. |
memo_log | История изменений ветки. |
Команда memo
Агенты работают с графом и через команду ~/.memo/bin/memo. Вы тоже можете ею пользоваться:
~/.memo/bin/memo list
Если что-то не так, команда одной строкой скажет, что делать:
- Ключ не принят, например потому, что доступ компьютера отозван: получите новый код на странице аккаунта и запустите установщик снова.
- Тариф не активен: оформите подписку на странице аккаунта. Панель тем временем продолжает работать.
Отключение компьютера
На странице аккаунта нажмите Отозвать рядом с компьютером. Его ключ сразу перестанет работать. Граф и другие компьютеры это не затронет.
Удаление
Чтобы убрать с компьютера файлы и настройки Memo, снова скачайте установщик и запустите его с --uninstall:
curl -fsSL https://memo.example/kit/install.py -o memo-install.py && python3 memo-install.py --uninstallУстановщик убирает из CLAUDE.md и AGENTS.md только блок Memo и восстанавливает ваши настройки из резервных копий, сделанных при установке.
Если после этого Claude Code всё ещё показывает MCP-сервер memo, удалите его:
claude mcp remove --scope user memo
Затем отзовите доступ компьютера на странице аккаунта, чтобы его ключ перестал работать.