В проекте claude-obsidian связка Claude и Obsidian начинается с отдельного пользовательского vault. Она не записывает автоматически все разговоры с моделью. В репозитории лежат плагин Claude Code, пакет Agent Skills и Python-ядро, а источники и заметки остаются обычными файлами. Их можно открыть без агента.
Для этого разбора мы зафиксировали коммит 9f8c1199047eac2c3828496279fbb7ba9540b90b, к которому привязан релиз v2.1.1. Проверили README, install guide, манифест плагина, документы о приватности и режимах организации заметок. Сам код не запускали. Поэтому речь идёт о документированной архитектуре и статически проверенных файлах, а не о результатах личного теста.
claude-obsidian — самостоятельный open-source проект AgriciDaniel под лицензией MIT. Он не является продуктом OdiRouter и не поставляется OdiRouter.
Что представляет собой claude-obsidian
README на проверенном коммите называет проект local-first системой знаний для Claude Code и совместимых хостов Agent Skills. Задача системы понятна: сохранить исходный материал, привязать заметки к доказательствам и использовать накопленное в следующих запросах.
Пользовательский vault состоит из Markdown, JSON и исходных файлов. Его не прячут в кэше плагина и не смешивают с clone репозитория. Код можно обновлять отдельно, не перенося вместе с ним каталог знаний.
Манифест версии 2.1.1 перечисляет source-cited knowledge base, recoverable transactions, deterministic lint, retrieval и provenance ledgers. Это цели и заявленные механизмы проекта, а не гарантия достоверности любой заметки. README прямо говорит, что проект не является factual oracle и не заменяет резервные копии.
Как Claude и Obsidian образуют цикл знаний
Работа начинается с источника, а не с пустой сгенерированной страницы.
Пользователь кладёт локальный источник в
inbox/выбранного vault.Команда capture готовит план и идентичность операции.
Пользователь проверяет план и применяет его с тем же
approved_plan_sha256.Skill
wiki-ingestсоздаёт связанные страницы и provenance records.wiki-queryчитает релевантный материал из vault.wiki-lintищет битые ссылки, orphan pages, пропуски metadata и другие проверяемые дефекты.saveзаписывает конкретный ответ или вывод только по явной команде.
В install guide capture разделён на preview и apply. Сначала оператор видит затрагиваемые пути и файлы, затем подтверждает точный хэш плана. Если цель успела измениться, старое одобрение не должно применяться к новому состоянию без проверки.
Происхождение источников и состояние утверждений учитываются отдельно. По документации, claim ledger хранит поддержку, противоречия, свежесть и статус проверки. Для принятых утверждений с высоким риском нужны два независимых источника. Такая модель помогает увидеть основание заметки, но сама по себе не делает утверждение истинным.
Код продукта и пользовательский vault — разные каталоги
После clone в каталоге продукта находятся claude_obsidian/, skills/, hooks/, scripts/, config/, templates/ и tests. Пользовательские знания должны лежать в другом месте.
Руководство описывает такой базовый состав vault:
inbox/хранит видимые входящие источники;.raw/содержит неизменяемые content-addressed копии;wiki/содержит связанные страницы, индексы и журналы;.obsidian/хранит минимальные настройки Obsidian;.vault-meta/используется для игнорируемого runtime state;.claude-obsidian.jsonзадаёт идентичность рабочего пространства и выбор vault.
Система ищет vault в определённом порядке: аргумент --vault, переменная CLAUDE_OBSIDIAN_VAULT, ближайший .claude-obsidian.json, затем один однозначно найденный инициализированный ancestor. При неоднозначности команда должна завершиться без записи. Каталог продукта не становится vault по умолчанию.
Раздельная настройка требует дополнительного шага. Зато личные заметки сложнее по ошибке записать в clone или кэш плагина.
Что делают 15 Agent Skills
В дереве проверенного коммита находится 15 файлов skills/*/SKILL.md. Это число относится к зафиксированному snapshot и может измениться в следующей версии.
Основной контур составляют wiki, save, wiki-ingest, wiki-query и wiki-lint. wiki проверяет готовность и направляет операцию. Остальные skills отделяют запись, чтение и проверку, поэтому одна общая команда не получает неявное право менять весь vault.
Дополнительные skills покрывают web-исследование с явным egress, Obsidian Canvas, очистку web-контента, свёртку operation log, режимы организации, BM25 retrieval и работу через Obsidian CLI. Справочные obsidian-markdown и obsidian-bases описывают форматы Obsidian. think задаёт отдельный review workflow.
В Claude Code у команд есть namespace, например /claude-obsidian:wiki-ingest. Другие хосты используют собственные правила обнаружения Agent Skills.
Как изучить проект до первой записи
Руководство по установке требует Python 3.11 или новее. Для Claude Code описаны marketplace installation и локальный --plugin-dir. Для Codex, OpenCode и Gemini предусмотрен preview-first установщик skills; Cursor и Windsurf используют workspace-local discovery.
Наиболее прозрачный путь знакомства начинается с clone и отдельного тестового vault:
git clone https://github.com/AgriciDaniel/claude-obsidian.git
cd claude-obsidianЗатем документация предлагает preview инициализации. Команда без --apply выводит JSON-план. После проверки каталога и списка изменений тот же operation ID применяется с полученным approved_plan_sha256.
python3 scripts/claude-obsidian.py init <new-vault> \
--generated-at <ISO-UTC> --operation-id init-reviewedДля существующего Obsidian vault есть отдельный workflow adopt: он сначала предлагает недостающие служебные файлы. Перед работой с реальными заметками стоит выполнить doctor, прочитать план и сделать обычную резервную копию. Такой порядок следует из документации; собственным запуском команд мы его не проверяли.
На native Windows доступны read-only inspection и dry runs, но для записи в vault руководство требует WSL. Актуальные детали собраны в инструкции для Windows и WSL. Платформенные ограничения могут измениться после v2.1.1.
Что local-first означает для приватности
В PRIVACY.md сказано, что portable core не содержит telemetry или analytics, хранит vault на выбранной файловой системе и сам не выполняет сетевые запросы. BM25 retrieval работает локально и детерминированно.
Но local-first не означает, что весь AI-сеанс всегда офлайн. Claude Code, другой host, web tool или отдельно настроенный adapter может передать выбранный контент своему provider. Contextual prefixes, удалённые модели и web research требуют отдельного egress decision. Политику каждого такого инструмента надо проверять независимо от репозитория.
По документации, SessionStart hook молчит без явной переменной CLAUDE_OBSIDIAN_SESSION_CONTEXT=1. С opt-in он добавляет ограниченный контекст, а не сохраняет transcript автоматически. Stop hook сообщает только aggregate recovery state, когда нужно вмешательство.
Generic, LYT, PARA или Zettelkasten
Skill wiki-mode предлагает четыре режима маршрутизации новых заметок. Generic использует типовые каталоги. LYT опирается на Maps of Content и атомарные заметки. PARA распределяет материал по проектам, областям, ресурсам и архивам. Zettelkasten использует стабильные идентификаторы и плотные связи.
Руководство по методологиям уточняет: смена режима действует на будущую маршрутизацию. Она не переносит старые заметки, не переписывает ссылки и не повышает достоверность материала. Массовая реорганизация остаётся отдельной миграцией со своим планом и rollback.
Режим стоит выбирать по тому, как вы действительно обслуживаете vault. Без настройки используется Generic.
Ограничения, которые стоит учесть
Core документирует работу с локальными файлами и ограниченный content-addressed capture. Для изображений, PDF и EPUB есть metadata-level обработка, но нет встроенного semantic extraction. URL, YouTube, OCR и transcription требуют отдельно configured runner. Optional model-based reranking должен возвращаться к BM25, если выбранная модель недоступна или её результат нельзя использовать доверенно.
Проект требует больше действий, чем обычная папка заметок: отдельный vault, проверка dry run, approval hash, явный выбор egress и backups. Если нужна автоматическая синхронизация или запись каждого диалога без участия пользователя, README относит это к другому классу продуктов.
Перед установкой нужно снова проверить release notes. Эта статья фиксирует v2.1.1; новая версия может поменять требования, команды и поддержку платформ.
Кому подойдёт такой подход
claude-obsidian стоит изучить тем, кто готов обслуживать Obsidian vault как набор обычных файлов и хочет видеть происхождение заметок, состояние утверждений и точные операции записи. Подход рассчитан на проверяемость и переносимость, а не на автоматическое накопление всего контекста.
Для знакомства с отдельной инфраструктурной AI-платформой можно открыть официальный сайт OdiRouter. OdiRouter не является автором claude-obsidian, не распространяет репозиторий как свой продукт и не подтверждает совместимость за пределами источников этой статьи.