Gemini Obsidian Extension — плагин
Расширение Gemini CLI подключает хранилище Obsidian: семантический поиск, граф ссылок, ежедневные заметки и правка разделов.
- 102 ★ репозитория
- Последний коммит
- ISC
Расширенный доступ
Почему такой уровень
- Расширение создает, перемещает и правит заметки в хранилище и читает журналы сессий терминала.
- Первая индексация нагружает процессор и пишет локальный индекс в домашнюю папку.
Установка
- Работает в
Ручная установка
gemini extensions install https://github.com/thoreinstein/gemini-obsidianПервая команда установки из README. После нее выполните `npm install` в каталоге расширения.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Расширение создает, перемещает и правит заметки в хранилище и читает журналы сессий терминала.
- Первая индексация нагружает процессор и пишет локальный индекс в домашнюю папку.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Расширение для Gemini CLI дает агенту доступ к локальному хранилищу Obsidian. Агент читает, ищет, создает и перемещает заметки, меняет frontmatter и отдельные разделы. Семантический поиск строит локальный индекс на LanceDB и отвечает на вопросы по заметкам. Граф знаний представлен обратными и исходящими ссылками и поиском битых викиссылок. Ежедневная заметка пополняется записями с отметкой времени под нужным заголовком. В комплекте слэш-команды `/obsidian:daily`, `/obsidian:recap`, `/obsidian:ask`, `/obsidian:search`, `/obsidian:index` и скиллы `compound`, `moc-update`, `link-audit`.
Для кого. Пользователям Gemini CLI, которые ведут заметки в Obsidian и хотят спрашивать агента по своему хранилищу и пополнять дневник из терминала.
Подходит, если
- Вопрос по накопленным заметкам вроде «что я записывал про React».
- Итоги рабочих сессий терминала собирают в ежедневную заметку через `/obsidian:recap`.
- Хранилище разрослось, и пора найти битые викиссылки и заметки-сироты.
- Метаданные десятков заметок меняют пакетно.
Не подходит, если
- Вы работаете в Claude Code или Cursor: расширение рассчитано на Gemini CLI.
- Папки `.obsidian` в хранилище нет: путь принимается только для существующего хранилища.
- В сессиях терминала за день попадали токены или пароли: `obsidian_harvest_cli_sessions` собирает ваши запросы в контекст модели.
Пример запроса к агенту
`/obsidian:ask "Что я узнал про React?"` и перечисли заметки, на которые опирается ответ.Ограничения
Нужны Node.js 18 или новее и ручной `npm install` в каталоге расширения: без него семантический поиск падает с ошибкой про `@lancedb/lancedb`. Первая индексация большого хранилища идет долго: на 957 заметках она заняла около 11 минут при загрузке почти четырех ядер процессора. Индекс лежит в `~/.gemini-obsidian-lancedb`, путь к хранилищу в `~/.gemini-obsidian.config.json`. Старые сессии Gemini CLI в формате `.json` инструмент сбора не читает.
Как отключить. Удалите расширение через управление расширениями Gemini CLI или папку `~/.gemini/extensions/gemini-obsidian`. Индекс `~/.gemini-obsidian-lancedb` и файл `~/.gemini-obsidian.config.json` удалите вручную.
Частые вопросы
Как установить расширение Obsidian для Gemini CLI?
Выполните `gemini extensions install https://github.com/thoreinstein/gemini-obsidian`, затем `npm install` в `~/.gemini/extensions/gemini-obsidian`. Без второго шага нативные зависимости семантического поиска не появятся.
Как указать путь к хранилищу?
Задайте переменную `OBSIDIAN_VAULT_PATH` или дождитесь первого вызова: агент спросит путь и вызовет `obsidian_set_vault`. Путь должен вести к папке с `.obsidian`.
Как ускорить индексацию большого хранилища?
Запустите `node dist/index.js obsidian_rag_index` из каталога расширения вне чата и подберите `GEMINI_OBSIDIAN_EMBED_BATCH_SIZE` и `GEMINI_OBSIDIAN_TARGET_CHUNK_CHARS`. Крупные фрагменты ускоряют работу, но снижают точность поиска.
Какие слэш-команды входят в расширение?
`/obsidian:daily` открывает ежедневную заметку, `/obsidian:recap` собирает итоги сессий, `/obsidian:ask` отвечает по хранилищу, `/obsidian:search` ищет по имени и тексту, `/obsidian:index` перестраивает индекс.
Где хранится индекс семантического поиска?
В папке `~/.gemini-obsidian-lancedb`. Если индекс повредился, удалите папку: следующий `/obsidian:index` или `obsidian_rag_index` создаст ее заново.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныХранилище Obsidian со скиллами для рабочих встреч: транскрипты из Gmail, участники, задачи и недельные итоги.
Obsidian Hybrid Search
obsidian-hybrid-search
Локальный поиск по хранилищу Obsidian: агент находит заметки по смыслу, словам, тегам и ссылкам через MCP, CLI или плагин.
CLI строит локальный индекс заметок с «катализаторами», вопросами по вашим записям, чтобы агент находил нужное лучше grep
Google Workspace для Gemini CLI
Google Workspace Extension for Gemini CLI
Расширение Gemini CLI для работы с Google Docs, Sheets, Slides, Gmail, Chat, Calendar и Drive из терминала
Шаблон vault в Obsidian с хуками, командами и скиллами, который дает Claude Code, Codex и Gemini CLI постоянную память между сессиями
Agent Client для Obsidian
Agent Client
Плагин Obsidian, который запускает Claude Code, Codex и другие агенты по Agent Client Protocol прямо внутри хранилища заметок
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Gemini Obsidian Extension (эта карточка) | нет | 102 | ||
| Obsidian MCP | нет | не нужна | 751 | MCP-сервер для работы с файлами хранилища; здесь расширение Gemini CLI с семантическим индексом и слэш-командами |
| Скиллы для Obsidian | нет | 52 183 | скиллы по форматам Obsidian; здесь рабочие инструменты чтения, поиска и записи заметок |
Коротко о README
Расширение объединяет поиск, граф ссылок, управление заметками и дневник. Для первой индексации большого хранилища автор советует отдельный запуск из терминала. Ошибки расширения выходят в stderr, потому что оно работает как MCP-сервер.