claude-obsidian — плагин
Плагин и набор скиллов, которые превращают хранилище Obsidian в базу знаний с источниками, связями и ответами по ней
- 15 944 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Пишет файлы в хранилище и запускает Python-скрипты
- Скилл autoresearch ходит в интернет после согласия
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/claude-obsidianОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Пишет файлы в хранилище и запускает Python-скрипты
- Скилл autoresearch ходит в интернет после согласия
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин работает с отдельным хранилищем Obsidian, которое создает скрипт scripts/claude-obsidian.py init. Источники вы кладете в папку inbox/, команда /claude-obsidian:wiki-ingest сохраняет их неизменяемые копии с адресацией по содержимому и строит связанные страницы с записями в реестрах источников и утверждений. Вопросы по накопленному задаются через wiki-query, и ответ собирается только из того, что уже есть в хранилище. Отдельные скиллы ищут по BM25 (wiki-retrieve), проверяют битые ссылки и сирот (wiki-lint), рисуют карты в Canvas (canvas) и ведут ограниченное веб-исследование (autoresearch). Любое изменение оформляется как одна транзакция: скрипт сначала выдает план с хешем approved_plan_sha256, а запись идет только после повторного запуска с этим хешем и флагом --apply. Если операция оборвалась, transaction recover восстанавливает прежнее состояние.
Для кого. Для исследователей, аналитиков и всех, кто ведет личную базу знаний в Obsidian и хочет, чтобы агент наполнял ее со ссылками на источники.
Подходит, если
- Накопилась папка статей и PDF по теме диссертации, и нужны связанные страницы с указанием, из какого источника взято каждое утверждение
- Вы хотите спросить хранилище «что мы знаем про ценообразование подписок» и получить ответ только из своих заметок, а при нехватке данных отказ без выдуманных ссылок
- Раз в неделю нужно чистить базу: wiki-lint покажет битые ссылки, сироты, пустые разделы и устаревшие индексы
- Ведете заметки по PARA или Zettelkasten: режим wiki-mode направляет новые заметки по выбранным правилам и не двигает старые
- У вас уже есть хранилище Obsidian, и его надо подключить без потерь: для этого есть команда adopt с планом и хешем
Не подходит, если
- Нужно автоматически записывать все разговоры с агентом: скилл save сохраняет только один заданный ответ
- Нужна память агента между сессиями с автоматическим сохранением решений: посмотрите obsidian-second-brain
- Нужны только диаграммы Excalidraw, Mermaid и Canvas из текста: хватит Obsidian Visual Skills Pack
- Вы работаете на нативной Windows: запись в хранилище там не работает, нужен WSL
Пример запроса к агенту
Разбери файлы из inbox/ по теме «регулирование ИИ в ЕС», добавь страницы с источниками в режиме PARA, а потом покажи через wiki-lint, какие страницы остались без входящих ссылокОграничения
Доступ: расширенный. Плагин читает и пишет файлы только в выбранном хранилище, выбор идет через CLAUDE_OBSIDIAN_VAULT, ближайший .claude-obsidian.json или единственный инициализированный родитель. Если выбор неясен, команда ничего не пишет. Сеть выключена, пока вы явно не разрешили выход: URL, YouTube и OCR требуют внешнего обработчика, PDF и EPUB разбираются только до метаданных, хеша и размера. Нужны Python 3.11 или новее и свежий Claude Code с hooks. Установка из клона репозитория с флагом --plugin-dir, для Codex, OpenCode, Gemini и ZCode есть setup-multi-agent.sh с предпросмотром. На нативной Windows работают только чтение и пробные запуски, запись требует WSL. Лицензия MIT, версия 2.2.0.
Как отключить. Запускайте Claude Code без флага --plugin-dir или удалите плагин через /plugin. Хранилище остается обычной папкой с файлами.
Частые вопросы
Мои заметки уходят в облако?
Нет, хранилище остается обычной папкой с Markdown и JSON. Сетевые запросы, например веб-исследование, выполняются только с явного согласия, а внешние обработчики для URL, YouTube и OCR настраиваются отдельно.
Можно подключить существующее хранилище?
Да. Для этого есть неразрушающая команда adopt, она так же выдает план с хешем и применяется только с флагом --apply. Подробности лежат в руководстве по установке, в разделе про подключение готового хранилища.
Как запустить и проверить, что плагин подхватился?
Откройте папку хранилища и выполните claude --plugin-dir /абсолютный/путь/к/claude-obsidian. Затем введите /claude-obsidian:wiki: скилл покажет готовность хранилища и подскажет следующий шаг. Диагностику можно запустить и скриптом: doctor --vault PATH.
Чем отличается от obsidian-second-brain?
Здесь упор на источники: неизменяемые копии, реестры утверждений и транзакции с откатом. obsidian-second-brain описан в каталоге как постоянная память агента в Obsidian: сохранение решений и поиск.
Операция оборвалась посреди записи, что делать?
Выполните python3 scripts/claude-obsidian.py transaction recover --vault /путь/к/хранилищу. Скрипт восстановит предыдущее состояние из журнала резервных копий. Если остался устаревший замок, добавьте флаг --force-stale-lock.
Почему не обрабатываются PDF по содержимому?
В таблице возможностей README указано, что для PDF и EPUB берутся только метаданные, хеш и размер, а встроенного извлечения смысла нет. Преобразуйте файл в текст или Markdown заранее и положите в inbox/.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныНабор скиллов, с которыми агент ведет личную вики в Obsidian: собирает знания из документов и прошлых сессий и отвечает со ссылками
Плагин Claude Code, который в разговоре собирает под вас систему знаний из markdown-файлов: структуру папок, шаблоны заметок, конвейер обработки и хуки
Постоянная память агента в хранилище Obsidian: сохранение решений, поиск, исследования и фоновое обслуживание базы
Четыре скилла для личной базы знаний в Obsidian: агент разбирает статьи и заметки в связанную вики, отвечает по ней и проверяет ее на ошибки
Шаблон vault в Obsidian с хуками, командами и скиллами, который дает Claude Code, Codex и Gemini CLI постоянную память между сессиями
Obsidian и Claude Code PKM
Obsidian + Claude Code PKM
Шаблон хранилища Obsidian для Claude Code: команды /daily, /weekly, /monthly и /project связывают цели на три года с задачами на сегодня
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| claude-obsidian (эта запись) | нет | 15 944 | |
| Second Brain OS | нет | 1 160 | шаблон хранилища Obsidian |
| RedNote to Obsidian | нет | 427 | плагин Claude Code превращает посты RedNote с текстом |
Коротко о README
README описывает цикл: сохранить источник, подтвердить утверждения, связать знания и снова использовать их в ответах. Быстрый старт состоит из клонирования, инициализации отдельного хранилища с проверкой плана и запуска Claude Code с плагином, для Codex, OpenCode и Gemini есть скрипт настройки. Перечислены 15 скиллов, модель транзакций и честная таблица того, какие форматы уже поддерживаются. В конце справочник по CLI и инструкции по обновлению и удалению.