memcli — одна команда для локальной памяти агента

Запуск

Собранный бандл поставляется в репозитории. Шаг сборки не требуется:

node cli/memcli/dist/memcli.js up --folder ./memory-vault

Что делает up:

1. Создаёт ./memory-vault/.trip2g-memory/ (режим 700, директория состояния) и генерирует случайный JWT_SECRET — при повторном запуске значение переиспользуется, поэтому up идемпотентен.
2. Запускает Docker-контейнер trip2g-memory с STORAGE_BACKEND=local — ассеты хранятся на диске, S3 и MinIO не нужны.
3. Выпускает административный API-ключ через HAT (Hot Auth Token) — без адреса электронной почты и без флага DEV=true.
4. Записывает ключ в .obsidian/plugins/trip2g/data.json внутри хранилища.
5. Запускает trip2g-sync --watch как фоновый процесс, синхронизирующий хранилище и сервер в обоих направлениях.
6. Печатает: memory live — web: http://localhost:24081 read/write .md in ./memory-vault

После запуска агент работает с папкой хранилища через обычные инструменты Write/Read/Grep. Специальный API памяти не нужен.

Предварительный просмотр без побочных эффектов:

node cli/memcli/dist/memcli.js up --folder ./memory-vault --dry-run

Сборка из исходников (только при изменении кода CLI):

cd cli/memcli && npm install && npm run codegen && npm run build

codegen читает GraphQL-схему из репозитория — запущенный сервер не нужен. Результат: обновлённый dist/memcli.js.

Субкоманды

Флаги для up:

Для запуска двух экземпляров одновременно дайте второму --name и отдельный --port. Состояние хранится per---folder, поэтому у каждого экземпляра свой хранилище:

node cli/memcli/dist/memcli.js up --folder ./vault-blog --name blog --port 24181
node cli/memcli/dist/memcli.js up --folder ./vault-work --name work --port 24281
# остановить по имени:
node cli/memcli/dist/memcli.js down --name blog

Флаги для daily / log:

Фиксация мыслей: daily vs log

Эти две команды — основной интерфейс для записи мыслей и наблюдений агента в ходе сессии.

node cli/memcli/dist/memcli.js daily "деплой только в нерабочие часы — прод на одной маленькой VM"

node cli/memcli/dist/memcli.js log work/deploy-rules "подтверждено: деплой в пиковые часы не допускается"

Хаб trip2g.com

При первом запуске up записывает в хранилище файл hub.md со следующим frontmatter:

mcp_federation_kb_url: https://trip2g.com/_system/mcp

Это подключает локальный MCP-эндпоинт к опубликованной базе знаний trip2g.com через федерацию MCP. Любой агент (или MCP-клиент), подключившийся к http://localhost:24081/_system/mcp, может обращаться к документации trip2g.com — включая документацию самой системы памяти — не выходя за пределы локальной памяти. Это федерация, а не копия.

hub.md — обычная Markdown-заметка. Удаление файла убирает федеративную связь при следующем цикле синхронизации.

• --no-hub — не создавать хаб вообще.
• --hub-url <url> — федерировать к другой базе знаний.

node cli/memcli/dist/memcli.js up --folder ./memory-vault --hub-url https://example.com/_system/mcp

Подключить собственный удалённый хаб

Вы можете добавить федерацию с вашим собственным экземпляром trip2g (или любым другим) — наряду с хабом trip2g.com по умолчанию. Несколько хабов сосуществуют: каждый получает собственный файл заметки.

node cli/memcli/dist/memcli.js hub https://demo.lahab.cc/_system/mcp

Команда записывает hub-demo.lahab.cc.md в хранилище с полями free: true (обязательно для обнаружения заметки при сканировании федерации) и mcp_federation_kb_url: https://demo.lahab.cc/_system/mcp. После того как запущенный демон --watch отправит заметку на сервер, инструмент federated_search будет также обращаться к вашему хабу.

Для краткого идентификатора используйте --id:

node cli/memcli/dist/memcli.js hub https://demo.lahab.cc/_system/mcp --id my-team

Для предпросмотра без записи — --dry-run:

node cli/memcli/dist/memcli.js hub https://demo.lahab.cc/_system/mcp --folder ./memory-vault --dry-run

MCP-инструмент memory_bind_hub делает то же самое в рамках MCP-сессии.

Замечания:

• Поле free: true добавляется автоматически — не удаляйте его, иначе сканер федерации проигнорирует заметку.
• Повторный запуск hub с тем же URL перезаписывает заметку (обновляя id или содержимое).
• Файл по умолчанию hub.md (trip2g.com) и дополнительные hub-<host>.md сосуществуют независимо.

Режим MCP

Запустите memcli с пайпом stdin или передайте субкоманду mcp — и memcli становится MCP stdio-сервером: JSON-RPC 2.0, реализован вручную, без внешних зависимостей.

# Явный запуск
node cli/memcli/dist/memcli.js mcp

# Автоопределение при пайпе stdin (например, от MCP-клиента)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node cli/memcli/dist/memcli.js

MCP-сервер предоставляет все команды как инструменты:

Это позволяет агенту управлять собственной инфраструктурой памяти через вызовы MCP-инструментов — удобно, когда агент подключён к MCP-эндпоинту локального сервера и хочет управлять им без отдельной CLI-сессии.

Просмотр в браузере

URL, выведенный командой up (например, http://localhost:24081), открывает хранилище памяти как навигируемый сайт. Удобно для просмотра написанного агентом.

Добавьте ?#!live_follow=1 к URL любой страницы — браузер перейдёт в cinema-режим и будет автоматически переходить к той заметке, которую агент редактирует в данный момент:

http://localhost:24081/?#!live_follow=1

Связанные страницы

• ru/user/agent-memory — полная настройка памяти для агента: подключение MCP, процесс поиска → expand → note_html, экономия токенов
• en/user/local-quickstart — справочник по sync CLI, флаг --watch, фильтры include/exclude