Obsidian Mind — персистентная память для ИИ-агентов через Obsidian

Obsidian Mind — это Obsidian-ваулт (хранилище заметок), который даёт ИИ-агентам кодирования постоянную память. Вместо того чтобы каждый раз начинать с нуля, агент помнит ваши цели, проекты, решения и контекст между сессиями.

Проблема

ИИ-агенты для кодирования (Claude Code, Codex CLI, Gemini CLI) каждый раз начинают сессию с чистого листа. Они не помнят:

• ваши текущие цели и North Star
• какие проекты активны, а какие в архиве
• решения, принятые три разговора назад
• паттерны и грабли, на которые вы уже наступали
• результаты встреч и 1:1

Знания не накапливаются. Каждый раз — реэксплейн.

Решение: ваулт как мозг агента

Obsidian Mind решает это через структурированное Obsidian-хранилище, которое агент читает и обновляет автоматически. Когда вы говорите «start session», агент загружает North Star, проверяет активные проекты, сканирует последние изменения — и начинает работу с полным контекстом.

Как это работает

Архитектура разделяет обязанности:

• Код хуков (TypeScript) — детерминированная обвязка: классификация, валидация, индексация. Не зависит от модели.
• Агент — пишет заметки, связывает их, принимает решения о структуре.
• Ваулт — плоское хранение + граф связей через вики-ссылки.

Пять жизненных хуков автоматизируют всю рутину:

• SessionStart — инъекция контекста при старте (North Star, активные проекты, задачи, git-статистика)
• UserPromptSubmit — классификация каждого сообщения: решение, инцидент, победа, 1:1, апдейт проекта
• PostToolUse — валидация заметок после записи: фронтматер, вики-ссылки, контроль размера
• PreCompact — бэкап транскрипта сессии перед сжатием контекста
• Stop — финальный чеклист при завершении

Эффективность токенов

Система не сбрасывает весь ваулт в контекст. Используется многоуровневая загрузка:

• Всегда (~2K токенов): CLAUDE.md + North Star, git-суммари, список файлов
• По запросу: семантический поиск QMD
• На каждое сообщение (~100 токенов): хинты классификации
• После записи (~200 токенов): валидация

Возможности

18 команд

Утренний /om-standup загружает контекст и показывает приоритеты. /om-dump сохраняет любую мысль в правильную заметку. /om-wrap-up вечером проверяет ссылки, обновляет индексы, находит незаписанные победы. /om-weekly делает кросс-сессионный синтез. Есть команды для 1:1, инцидентов, обзоров кода, подготовки к ревью и архивации проектов.

9 суб-агентов

Изолированные агенты для тяжёлых операций: brag-spotter (поиск незаписанных достижений), context-loader (загрузка контекста о человеке или проекте), slack-archaeologist (восстановление всего треда из Slack), vault-migrator (миграция из старого ваулта) и другие.

Граф производительности

Заметки о работе автоматически связываются с компетенциями. Когда наступает сезон ревью, бэклинки на каждой компетенции уже содержат полную цепочку доказательств. Brag Doc агрегирует победы по кварталам. Команда /om-review-brief генерирует структурированную подготовку к ревью.

Семантический поиск (QMD)

QMD — опциональный, но рекомендуемый компонент. Он добавляет семантический поиск: «что мы решили по поводу кэширования» находит заметку «Redis Migration ADR», даже если в запросе нет слова «redis». Работает через MCP-сервер, доступный всем суб-агентам и командам.

Установка

Рекомендуемый способ — через ShardMind:

npm install -g shardmind
mkdir my-vault && cd my-vault
shardmind install github:breferrari/obsidian-mind

Визард собирает имя, организацию, цели и настраивает North Star. Затем откройте папку как Obsidian-ваулт (1.12+), включите Obsidian CLI и запустите агента.

Можно также просто склонировать репозиторий:

git clone https://github.com/breferrari/obsidian-mind.git

Совместимость с агентами

• Claude Code — полная поддержка (хуки, команды, суб-агенты)
• Codex CLI — хуки через .codex/hooks.json (те же скрипты)
• Gemini CLI — хуки через .gemini/settings.json
• Другие агенты (Cursor, Windsurf, Copilot) — читают AGENTS.md

Структура ваулта

• brain/ — North Star, ключевые решения, паттерны, памяти
• work/ — активные проекты, архив, инциденты, 1:1
• org/ — люди и команды
• perf/ — Brag Doc, компетенции, свидетельства для ревью
• bases/ — динамические БД-представления (дашборды проектов, люди, инциденты)
• .claude/commands/ — 18 команд
• .claude/agents/ — 9 суб-агентов
• .claude/scripts/ — хуки
• templates/ — шаблоны с YAML-фронтматером

Всё закоммичено в git. Знания переживают смену машины.

Кастомизация

Это стартовая точка. Вы можете менять North Star, добавлять свои компетенции, команды и суб-агентов. CLAUDE.md — операционное руководство, которое агент читает каждую сессию. Меняйте конвенции — и агент подстроится.

Для кого

Для разработчиков, которые регулярно работают с ИИ-агентами кодирования и хотят, чтобы знания накапливались, а не терялись между сессиями. Особенно полезно для:

• ежедневной работы с Claude Code / Codex CLI / Gemini CLI
• команд, где агент помогает нескольким разработчикам
• подготовки к performance review с автоматическим сбором evidence
• ведения инцидентов и принятия архитектурных решений