Коротко
Установите плагин Local Sync для Obsidian: он синхронизирует выбранные папки vault с каталогом в файловой системе — например, с папкой /docs в репозитории, куда Cursor и Claude Code уже умеют заглядывать. Агент читает обычные Markdown-файлы и получает актуальный контекст из ваших заметок без ручного копирования и без API. Синхронизация двусторонняя и работает в реальном времени: правка в Obsidian сразу появляется в /docs, а файл, который пишет агент, возвращается в vault. Всё происходит локально на вашей машине, а доступные агентам папки вы выбираете сами.
Заметки команды живут в Obsidian: PRD, спеки, инструкции, база знаний. AI-инструменты — Cursor, Claude Code, автономные агенты — живут в репозитории и читают файлы из проекта, чаще всего из папки /docs. Между этими двумя мирами обычно стоит стена: чтобы агент увидел свежий контекст, кто-то вручную копирует заметки в репозиторий. Копия почти сразу устаревает, и агент работает по вчерашней версии.
Эту стену убирает синхронизация на уровне файлов. Ниже — как устроена связка «Obsidian → /docs → AI-инструмент», почему ручное копирование проигрывает и как настроить двустороннюю синхронизацию за несколько минут.
Проблема: заметки в Obsidian, агенты — в репозитории
AI-инструменты работают с файлами. Obsidian хранит знания внутри себя. Cursor и Claude Code отлично читают /docs в репозитории, но не умеют сами заглядывать в ваш vault. В результате контекст, который вы аккуратно ведёте в заметках, не доходит до агента — или доходит в виде устаревшей ручной копии.
Типичный сценарий: продакт держит PRD и спеки в Obsidian, разработчик подключает AI-ассистента к репозиторию, а синхронизация между ними сводится к «не забудь выгрузить актуальную версию». Забыли — агент сгенерировал код по старому ТЗ. Это не проблема инструментов, это разрыв в синхронизации данных.
Решение: двусторонняя синхронизация выбранных папок
Local Sync — плагин для Obsidian от Entire VC. Он монтирует выбранные папки вашего vault в указанный каталог файловой системы и следит за изменениями в реальном времени. Вы указываете, например, папку /docs внутри рабочего репозитория — и заметки из Obsidian оказываются там, где агенты уже умеют работать.
Синхронизация двусторонняя. Изменения из Obsidian появляются в папке файловой системы; изменения из папки — обратно в vault. Агент пишет результат в синхронизируемую папку — он появляется в Obsidian как новая заметка. Человек и AI-инструмент работают с одними и теми же данными, без двух расходящихся копий.
Почему это лучше ручного копирования и API
Ручное копирование заметок в /docs создаёт ровно ту проблему, ради которой всё затевалось: две версии правды. Local Sync следит за изменениями через файловую систему, поэтому /docs всегда повторяет актуальное состояние vault — без отдельного шага «выгрузить перед запуском агента».
Отдельный API к Obsidian тоже не нужен. Файлы синхронизируются как обычные .md без проприетарных форматов, поэтому любой инструмент, умеющий читать файлы — Cursor, Claude Code, автономные агенты, MCP-серверы — получает прямой доступ к контексту. Агенту не нужно учить новый протокол: он просто читает Markdown из папки.
И всё это локально. Данные не покидают вашу машину: никаких облачных серверов и внешних зависимостей. Вы сами выбираете, какие папки доступны агентам — рабочие заметки, инструкции, шаблоны, база знаний, — а личные разделы остаются только в vault.
Как настроить синхронизацию Obsidian с /docs
Настройка занимает несколько минут и не требует кода:
- Установите плагин. Откройте Obsidian → Settings → Community Plugins → Browse → найдите Local Sync → установите и включите.
- Укажите папку синхронизации. В настройках плагина задайте путь к каталогу, куда агенты уже имеют доступ — например,
/docsв рабочем репозитории или отдельную папку~/projects/context/. - Выберите разделы vault. Отметьте папки, которые должны быть доступны агентам: PRD и спеки, инструкции, шаблоны, база знаний. Личные разделы не синхронизируются.
- Готово. Плагин запускает синхронизацию и следит за изменениями. Cursor и Claude Code читают
/docsкак обычно — но теперь там всегда актуальная версия ваших заметок.
После этого workflow выглядит так: vault → Local Sync → /docs → актуальный контекст агента при каждом запуске. И обратно: агент пишет файл → Local Sync → новая заметка в vault → история работы в одном месте.
Когда нужна командная синхронизация
Local Sync решает задачу одного человека: ваш vault и ваши AI-инструменты работают с одними данными. Когда участников несколько и одни и те же документы нужны всей команде, добавляется Team Relay — self-hosted-доступ к Obsidian-vault для команды. Связка простая: Team Relay открывает vault участникам workflow, Local Sync отдаёт его AI-агентам. Продакты и разработчики держат PRD и спеки в Obsidian, а AI-инструменты работают с ними через /docs в репозитории.
Если синхронизация заметок — это часть более широкой задачи «собрать базу знаний, с которой работают и люди, и агенты», начните с разбора того, как устроена корпоративная база знаний для AI-команды: синхронизация файлов — её техническая основа, но не вся картина.
Коротко
Синхронизация Obsidian с /docs убирает разрыв между тем, где команда ведёт знания, и тем, откуда их читают AI-инструменты. Local Sync делает это двусторонне, в реальном времени и локально, без ручного копирования и без API. В результате Cursor, Claude Code и агенты всегда работают с актуальным контекстом, а история их работы возвращается обратно в ваш vault.
Подробнее о самом плагине — на странице Local Sync; о том, как встроить синхронизацию в работу агентов, — в разделе про внедрение AI-агентов и в общем разделе AI.
Частые вопросы
Как синхронизировать Obsidian с /docs и AI-инструментами?
Установите плагин Local Sync для Obsidian: он синхронизирует выбранные папки vault с каталогом в файловой системе — например, с папкой /docs в репозитории. Cursor, Claude Code и автономные агенты читают эти Markdown-файлы напрямую и получают актуальный контекст из ваших заметок без ручного копирования и без API. Синхронизация двусторонняя: правки в Obsidian появляются в /docs, а файлы, которые пишет агент, возвращаются в vault.
Чем синхронизация через Local Sync лучше ручного копирования заметок в /docs?
Ручное копирование создаёт две расходящиеся копии: заметка в Obsidian живёт своей жизнью, файл в /docs — своей, и агент почти всегда читает устаревшую версию. Local Sync следит за изменениями в реальном времени, поэтому /docs всегда повторяет актуальное состояние vault, а вы не тратите время на ручную выгрузку перед каждым запуском агента.
Уходят ли данные в облако при синхронизации Obsidian?
Нет. Local Sync работает полностью локально: файлы синхронизируются внутри вашей машины, без облачных серверов и внешних зависимостей. Вы сами выбираете, какие папки vault доступны агентам, а личные разделы остаются только в Obsidian.
С какими AI-инструментами работает синхронизированная папка?
С любым инструментом, который умеет читать файлы: Cursor, Claude Code, автономные агенты, MCP-серверы. Local Sync синхронизирует заметки как обычные Markdown-файлы без проприетарных форматов, поэтому агенту не нужен отдельный коннектор к Obsidian — он просто читает .md из синхронизируемой папки.