Роль в цикле: установка — то, чем цикл переносится на новую машину. Она кладёт шаблоны, которые пишут журнал переиспользования, а в исследовательском режиме ещё и пре-регистрацию, и правило, обязывающее агента пройти измеряемый канал до того, как он предложит план.
Первая команда ставит сам пакет, вторая подключает его к вашему агенту:
uv tool install --editable . # или: pipx install .
engmem install --agent claude # или copilot-ide / copilot-cli / claude-desktop / codex / chatgpt
Инструменты разбора из tools/ в пакет не входят. Они лежат в клоне репозитория и запускаются из любой папки через него:
uv run --project <engmem-checkout> python <engmem-checkout>/tools/verify_citations.py --store <store>
Так что на новую машину установка переносит первые шаги цикла, а для разбора нужен ещё и клон.
--editable означает, что после git pull новый код подхватится сам, без переустановки — для инструмента, который сейчас активно правится, это важнее «красивой» установки.
Режим установки диктует агент-потребитель: у каждого свой каталог и свой формат файла.
Что install создаёт на самом деле
Четыре следа в трёх местах — знать их полезно, потому что именно они потом удаляются:
- хранилище (
~/Developer/engmem по умолчанию): папка sessions/ и git init, если репозитория ещё нет. Существующее не трогается;
- три файла шаблонов в каталоге агента из таблицы выше;
- штамп версии первой строкой после YAML-шапки каждого шаблона — по нему видно, какая версия установлена;
- триггер-правило в
CLAUDE.md, .github/copilot-instructions.md или, у Codex, в AGENTS.md — на самом деле две строки: сентинел-комментарий <!-- engmem-trigger-rule --> и сама строка правила сразу под ним: Before proposing a plan, run `engmem search "<key terms for the task>" --session <draft-id>` (the draft `/engmem` just created; without it the search is unattributed). Сентинел здесь не для красоты — именно по нему uninstall потом находит и убирает ровно эти две строки и ничего больше. Для copilot-cli этот шаг пропускается — глобального файла инструкций у него нет, навыки вызываются вручную; у claude-desktop и chatgpt файла с правилом тоже нет.
Повторный запуск — это upgrade: хранилище не пересоздаётся, шаблоны перезаписываются свежей версией, правило не дублируется (проверка идёт по маркеру engmem search, так что даже переформулированное вами правило распознаётся). Шаблон, который вы поправили, не перезаписывается: в штампе лежит дайджест текста, который записал engmem, поэтому install видит правку, оставляет ваш файл, кладёт новую версию рядом как <файл>.engmem-new и выходит с кодом 2, назвав оба пути.
Режим, хранилище и проверка
У тула два однострочных файла настроек, оба в ~/.config/engmem/ ($XDG_CONFIG_HOME/engmem/, в Windows — %APPDATA%\engmem\): store — путь к хранилищу, его пишет только engmem store set, и mode — режим, его пишет только engmem mode set. install не пишет ни тот, ни другой. Удалили файл — настройка вернулась к умолчанию.
В самом хранилище рядом с sessions/ со временем появляются файлы, которые пишет тул: telemetry.jsonl — строка на каждый поиск, versions/ — копии показанных версий документов (с .gitattributes, чтобы git не переписывал в них концы строк), feedback.jsonl — ваши оценки находок, cost.jsonl — размеры ответов поиска и чтения, без самого текста. Сводки по двум последним печатают engmem feedback summary и engmem cost summary --session <id>.
engmem mode set research # следующие сессии идут по протоколу Gate 1
engmem mode show # режим и откуда он взят
engmem store show # какое хранилище в работе и куда смотрят MCP-записи
По умолчанию режим дневной: /engmem не пишет пре-регистрацию, не запускает под-агента, и сессия в разбор не попадает. Исследовательский режим — это цикл из части 1 целиком. Режим записывается в черновик и потом не меняется, так что переключение действует со следующей сессии. Если файл режима не читается, молча это не проходит: engmem mode show выходит с кодом 2 и называет файл, агент говорит вам об ошибке, и сессия идёт в дневном режиме, единственном, который не может испортить эксперимент. Пока файл не исправлен (engmem mode set daily|research), MCP-инструмент принимает только дневные черновики. После обновления с версии без режимов install нужно запустить заново для каждого агента: старые шаблоны пишут черновик без mode, и MCP-инструмент его не примет.
У Claude Desktop нет shell, поэтому режим ставят один раз из терминала. Переменные из профиля shell приложение не видит: если XDG_CONFIG_HOME задан только в терминале, mode set запишет файл, который сервер Desktop не прочитает.
Если агент не видит память и непонятно почему, engmem doctor --agent <агент> проверяет установку этого клиента и ничего не меняет: хранилище и откуда оно взято, чтение и запись в sessions/ (одним пробным файлом, который сразу удаляется), команду engmem и Python из MCP-записи, шаблоны и то, совместим ли записанный в них порядок работы с этой версией (несовместимый — это error), правило, то, смотрят ли CLI и MCP в одно хранилище, и какую версию engmem последним вызовом записал в лог запущенный MCP-сервер: клиент держит старый сервер, пока его не перезапустят. На каждую проверку строка: ok, warning, error или unverified. Песочницу самого клиента doctor изнутри не видит, поэтому ok про неё не бывает. Код выхода 1, если нашлась хоть одна error.
Чтобы один раз пройти цикл целиком до того, как класть в хранилище свою историю, есть engmem walkthrough codex --dir ~/engmem-demo. Команда собирает в этой папке демо-хранилище, свой CODEX_HOME для Codex и маленький репозиторий с примером, проверяет их через doctor и печатает, что набрать в Codex: первая сессия сохраняет решение, вторая находит его снова. Ваше хранилище и ~/.codex она не трогает. В демо-папке Codex попросит войти ещё раз: ваш логин туда не копируется. engmem walkthrough handoff --dir ~/engmem-handoff делает то же для двух клиентов сразу: Codex сохраняет решение, Claude Code в соседнем репозитории находит его и сохраняет своё, а новая сессия Codex находит это второе по id. Хранилище у них одно, папки разные. Потом --verify с той же --dir проверяет по демо-хранилищу, что запись сохранилась и другая сессия её нашла. У handoff он сначала сверяет, что оба клиента смотрят в одно хранилище, и если нет, называет оба и дальше не проверяет.
Чтобы отдать коллеге одно решение и не отдать вместе с ним всё хранилище, есть engmem export <id>. Первый запуск только показывает: весь текст будущего файла, список того, что вырезано, и отпечаток этих байтов. Ссылки на другие ваши документы и локальные пути заменяются на [excluded reference]: id и имена файлов других документов, журнал переиспользования целиком (он цитирует другие документы), заголовки документов, на которые этот ссылается, и заголовки остальных, если в них хотя бы два слова. Поля шапки вне короткого списка, related и superseded_by в их числе, в файл не попадают вовсе. Заголовок из одного слова, на который никто не ссылается, обычно просто слово, поэтому он остаётся. Имена репозиториев, коммиты и ссылки на PR остаются: по ним решение можно проверить. Файл пишет второй запуск, engmem export <id> --out <файл> --confirm <отпечаток>, и только если текст с тех пор не поменялся. Существующий файл он не перезаписывает, внутрь хранилища не пишет, черновики не отдаёт. Хранилище после этого байт в байт то же, по сети ничего не уходит. MCP-инструмента для экспорта нет, так что сам агент вынести документ из хранилища не может.
Удаление
Зеркальная команда с тем же --agent:
engmem uninstall --agent claude
Она удаляет ровно те файлы, что ставила, и убирает ровно те строки триггер-правила, которые сама написала — сентинел-комментарий и строку правила сразу под ним (а для установок постарше, без сентинела, — саму строку правила, побайтово). Совпадение узкое и точное — почему не широкое, разобрано в пути 2. Реальный вывод:
engmem uninstalled: 3 template file(s) removed, 2 trigger rule line(s) removed, agent=claude
store left untouched: /Users/…/Developer/engmem (your documents — remove it yourself if you want)
Запускать повторно безопасно — второй раз вернёт нули.
Чего она принципиально не делает:
- не трогает хранилище. Это ваши документы, а не файлы инструмента: они остаются читаемым markdown в git и без engmem. Команда лишь печатает путь, чтобы вы решили сами;
- не удаляет чужое. Каталог навыка Copilot сносится, только если после удаления
SKILL.md он пуст; посторонние строки в CLAUDE.md сохраняются, сам файл не удаляется, даже если опустел;
- не удаляет сам пакет — команда
engmem остаётся в PATH.
Поэтому полное удаление — пять шагов, и только первый обязателен для того, чтобы агент перестал звать несуществующую команду:
engmem uninstall --agent claude # шаблоны и триггер-правило
uv tool uninstall engmem # сам пакет и команда в PATH
rm -rf ~/.config/engmem # настройки store и mode (в Windows — %APPDATA%\engmem)
rm -rf ~/.cache/engmem # кэш разбора, его можно удалить в любой момент
rm -rf ~/Developer/engmem # документы, журналы и копии версий — только если точно не нужны
Демо из engmem walkthrough удаляется вместе со своей папкой: хранилище, настройки Codex и репозитории лежат внутри неё. Снаружи остаются только следы самих сессий. Кэш разбора у демо общий с вашим хранилищем, и поиск по демо может выкинуть из кэша записи ваших документов; следующий ваш поиск их пересоберёт. А после handoff Claude Code сам, как для любой папки, помнит доверие к storefront/ в ~/.claude.json и хранит транскрипт в ~/.claude/projects/.