Проблема: AI-агенты забывают контекст
Современные AI-кодинговые агенты (Claude Code, Codex CLI, Gemini CLI) обладают высокой мощностью, но страдают от критического недостатка: каждый новый сеанс начинается с чистого листа. Разработчики вынуждены заново объяснять цели проекта, архитектурные решения и контекст команды. Знания не накапливаются, а решения, принятые три диалога назад, теряются. Obsidian Mind от разработчика Breferrari предлагает решение: дать агенту «мозг» в виде персистентного хранилища Obsidian, где каждая сессия опирается на предыдущие.
Как это работает: Архитектура и интеграция
Проект использует Obsidian Vault как единую базу знаний. При запуске сессии агент считывает «North Star» (стратегические цели), активные проекты и недавние записи. Система поддерживает три ключевых сценария:
- Утренний стендап (/om-standup): Агент загружает активные задачи, изменения в Git и напоминает о встречах (например, о блокировках на API-контракте).
- Запись решений (/om-dump): После 1:1 с менеджером агент автоматически обновляет профили сотрудников, создает записи о решениях (Decision Records) и обновляет статусы задач.
- Реакция на инциденты (/om-incident-capture): Анализ логов Slack, создание таймлайнов и фиксация причин сбоев.
Технологическое ядро: QMD и локальный поиск
Ключевая особенность — интеграция с QMD (Quantum Memory Database) для семантического поиска. Это позволяет находить информацию по смыслу, а не только по ключевым словам (например, найти решение о кэшировании в документе с названием «Redis Migration ADR»). QMD работает локально, не требуя API-ключей и платных запросов.
| Модель | Размер | Функция в стеке QMD |
|---|---|---|
| Gemma-300M | ~328 MB | Векторизация заметок и запросов (Embedding) |
| qmd-query-expansion-1.7B | ~1.28 GB | Перефразирование запроса для улучшения поиска |
| Qwen3-Reranker-0.6B | ~640 MB | Ранжирование результатов по релевантности |
Система использует гибридный поиск: qmd search (BM25, без моделей), qmd vsearch (векторный) и qmd query (гибридный). При отсутствии GPU работает на CPU, при наличии — использует CUDA или Metal. Если QMD не установлен, система корректно падает в режим обычного grep-поиска.
Установка и требования
Для работы требуется Obsidian 1.12+ (для поддержки CLI), Node 22+ LTS и один из агентов: Claude Code (полная поддержка), Codex CLI или Gemini CLI. Установка осуществляется через пакетный менеджер ShardMind или клонированием репозитория.
Быстрый старт:
- Установка через ShardMind:
npm install -g shardmind→shardmind install github:breferrari/obsidian-mind - Или прямой клон:
git clone https://github.com/breferrari/obsidian-mind.git
После инициализации необходимо включить Obsidian CLI в настройках и запустить агента в директории хранилища. Все данные версионируются через Git, что обеспечивает безопасность и историю изменений.
Источник: Github ↗
