MergeMind

Общая память для команды агентов Claude Code и Codex CLI: markdown-vault (Obsidian-совместимый) с гибридным поиском (BM25 + vector + rerank) и куратором-Индексом.

Канонические папки (знания, решения, идеи, проекты, списки) + личная оперативка каждого агента + архив финальных статусов. Все автоматизированно — единый MCP-сервер даёт vault_search / vault_read / vault_map / vault_graph тулы любому подключённому peer'у; куратор-Индекс размещает черновики, ведёт frontmatter, поддерживает связи и теги; demon-уровень (writer, watcher, tags-mirror, index-regen) живёт в launchd-плистах и поддерживает БД свежей.

Установка

Плагин ставится через централизованный agfpd marketplace (private gh-репо):

# Claude Code
claude plugin marketplace add agfpd/agfpd-marketplace
claude plugin install MergeMind@agfpd --scope project

# Codex CLI
codex plugin marketplace add agfpd/agfpd-marketplace
codex plugin add MergeMind@agfpd

После install — перезапусти Claude Code / Codex в cwd peer'а. SessionStart hook MergeMind на первом запуске сам:

• создаст IAPeer namespace ~/.iapeer/{state,cache,logs,plugins}/mergemind/;
• скопирует config.env из default template'а в ~/.iapeer/plugins/mergemind/config.env (правишь руками — vault path, embedding/reranker endpoints, human name);
• создаст минимальный <cwd>/.iapeer/peer-profile.json с personality (резолвится из basename cwd, lowercase);
• скопирует MERGEMIND.template.md в ~/.iapeer/MERGEMIND.md (Слой 2 — глобальные пользовательские правила) и <cwd>/.iapeer/MERGEMIND.md (Слой 3 — cwd-специфичные);
• установит 4 плагин-managed launchd-плиста (com.mergemind.{writerd,obsidian-watcher,tags-mirror,index-regen}) идемпотентно;
• инжектирует трёхслойный бутерброд гайда + индекс заметок автора в системный контекст сессии через stdout.

Никаких ручных connect-* команд — одна команда установки + restart.

Первичная инициализация (если vault ещё не существует)

Если это первый install MergeMind на хосте (vault не создан, Index'а нет) — запусти skill /MergeMind:init после установки плагина. Skill:

1. Соберёт у тебя 5 параметров (путь vault, имя человека-владельца, Telegram-бот для Index'а, chat_id, опциональные embedding/reranker endpoints).
2. Создаст структуру vault (00_Входящие/, 01_Знания/, …, 99_Система/).
3. Заполнит ~/.iapeer/plugins/mergemind/config.env твоими значениями.
4. Развернёт Index через /persistent-peer:create-peer (требует плагин persistent-peer@agfpd).

Скиллы

| Skill | Назначение | |---|---| | /MergeMind:init | Первичная инициализация (vault + config.env + Index). Используется один раз на хост. | | /MergeMind:migrate-memory <agent> [<project-dir>] | Перенести Anthropic auto-memory в 06_Оперативка_агентов/<agent>/ MergeMind. Маппинг детерминированный по type старого frontmatter. Backup в ~/.iapeer/state/mergemind/migration-backup/. | | /MergeMind:distill-my-memory | Глубокая ручная дистилляция оперативки агента с human-in-the-loop через Telegram. Фактчек через WebFetch, переезд общего знания в каноники, переименование filename'ов. | | /MergeMind:status | Диагностика: config.env, vault, демоны, peer'ы, Index. |

Архитектура

• MCP-сервер публикуется в npm как @agfpd/mergemind-mcp. .mcp.json плагина вызывает его через npx -y @agfpd/mergemind-mcp@latest — новая версия подтягивается автоматически при старте сессии.
• Сам плагин (skills, hooks, plist templates, shared docs) лежит в gh-репо agfpd/MergeMind, ставится через cache-snapshot модель Claude Code / Codex.
• Daemons (writer / obsidian-watcher / tags-mirror / index-regen) — launchd-плисты, поднимаются mergemind-plists-install.sh идемпотентно из SessionStart hook'а.
• Index — куратор vault'а; создаётся через /persistent-peer:create-peer как живая Claude-сессия с Telegram-каналом.
• IAPeer namespace — все state/cache/logs живут в ~/.iapeer/{state,cache,logs,plugins}/mergemind/. Симметрично с другими IAPeer-плагинами (Inter-Agent-Protocol, Spawned-Peer, Persistent-Peer).

Зависимости

• bun ≥ 1.0 на хосте (MCP-сервер и writer-daemon).
• node ≥ 18 (obsidian-watcher и tags-mirror).
• Для команды агентов: persistent-peer@agfpd (для Index'а), Inter-Agent-Protocol@agfpd (для общения Index'а с peer'ами), любой telegram-плагин (для канала Index'а).

Документация

Полная документация — в docs/:

• 01-vault-layout.md — структура vault'а, frontmatter, секции связей.
• 02-zones-and-roles.md — кто что правит, зоны автора/Индекса/человека.
• 03-operatives.md — оперативка агентов, DreamWeaver, дистилляция.
• 04-genres.md — жанры заметок и их шкалы статусов.
• 05-pipelines-and-hooks.md — pipeline Индекса, события, hook'и.
• 06-tags.md — словарь тегов, правила тегирования.
• 07-infra.md — launchd-плисты, плагин-managed демоны, операционные нюансы.

Лицензия

MIT.