top of page

Obsidian CLI на Windows: установка, основные команды и примеры автоматизации

  • Фото автора: REASONABLE
    REASONABLE
  • 19 июл.
  • 4 мин. чтения

Официальный Obsidian CLI связывает терминал с настольным приложением. Через PowerShell можно создавать и читать заметки, дописывать ежедневник, искать текст, получать список задач и управлять плагинами. Это не отдельный файловый конвертер и не полностью автономный сервер: команды обращаются к запущенному Obsidian.

Для Windows важны две детали. Нужен новый установщик ветки 1.12, а после включения CLI следует перезапустить терминал. Если эти условия соблюдены, команда obsidian становится обычной точкой входа для сценариев PowerShell и Планировщика заданий.

Установка в Windows

  1. Скачайте свежий установщик Obsidian с официального сайта. Документация CLI указывает версию установщика 1.12.7 или новее.

  2. Установите обновление поверх текущей версии. Обычного внутреннего обновления приложения может быть недостаточно, поскольку CLI добавляет системный компонент.

  3. Откройте Settings, затем General и включите Command line interface.

  4. Подтвердите регистрацию команды и полностью закройте старые окна PowerShell, Windows Terminal или cmd.

  5. Откройте новый терминал и проверьте справку.

obsidian help

Установщик размещает рядом с Obsidian.exe перенаправитель Obsidian.com. Расширение .com здесь не означает интернет-адрес: Windows использует этот файл как консольную точку входа к графическому приложению. Если Obsidian закрыт, первая команда запустит его. Выполнение продолжится после установления связи.

Интерфейс Obsidian с локальным хранилищем заметок
CLI управляет тем же локальным хранилищем, которое открыто в настольном Obsidian. Изображение: Obsidian.

Как устроен синтаксис

Команда начинается с obsidian, затем идет действие и параметры в форме ключ=значение. Значения с пробелами заключаются в кавычки. Флаги передаются без знака равенства.

obsidian create name="Проекты/Новый сайт" content="Первая заметка" open

Без аргументов команда obsidian открывает интерактивный терминальный интерфейс. В нем доступны история и поиск по истории через Ctrl+R. Для автоматизации удобнее явные однострочные команды: они предсказуемо возвращают результат в конвейер PowerShell.

Как выбрать хранилище

Если терминал открыт внутри папки хранилища, CLI использует ее. Иначе команда работает с активным хранилищем в Obsidian. Для сценария, который запускается по расписанию, лучше всегда задавать vault явно. Этот параметр должен стоять первым.

obsidian vault="Рабочие заметки" search query="квартальный отчет"

Можно указывать имя хранилища или его идентификатор. Идентификатор надежнее, если два хранилища имеют одинаковые имена.

Основные команды

Создание и чтение заметок

obsidian create name="Идеи/Новая функция" content="Проверить спрос" open
obsidian read file="Идеи/Новая функция"

Флаг open открывает созданную заметку в приложении. Если файл уже существует, CLI не должен молча уничтожать его содержимое. Флаг overwrite используйте только тогда, когда перезапись действительно предусмотрена сценарием.

Ежедневные заметки

obsidian daily
obsidian daily:append content="- [ ] Подготовить отчет к 16:00"

Команда daily открывает или создает ежедневную заметку согласно настройкам соответствующего встроенного плагина. daily:append добавляет текст в конец. Это удобный и относительно безопасный способ автоматизации, потому что существующий дневник не перезаписывается.

Поиск, задачи и теги

obsidian search query="статус: готово" format=json
obsidian tasks daily
obsidian tags counts

Формат JSON полезен, когда результат нужно разобрать в PowerShell. Список задач можно ограничивать ежедневной заметкой, а counts превращает вывод тегов в быстрый отчет по структуре хранилища.

Шаблоны и история

obsidian create name="Встречи/2026-07-17" template="Шаблоны/Встреча"
obsidian diff file=README from=1 to=3

Команда create умеет применять существующий шаблон. diff сравнивает версии файла, если история доступна через используемый сервис синхронизации или механизм версий.

Практическая автоматизация в PowerShell

Утренний блок в ежедневнике

Следующая последовательность добавляет заголовок и три пункта. Каждая команда выполняется отдельно, поэтому сбой проще заметить в журнале Планировщика заданий.

obsidian vault="Рабочие заметки" daily:append content="## Фокус дня"
obsidian vault="Рабочие заметки" daily:append content="- [ ] Главная задача"
obsidian vault="Рабочие заметки" daily:append content="- [ ] Один важный звонок"
obsidian vault="Рабочие заметки" daily:append content="- [ ] Разобрать входящие"

Экспорт результатов поиска

obsidian vault="Рабочие заметки" search query="#ожидает" format=json | Set-Content -Encoding utf8 "$env:USERPROFILE\Desktop\waiting.json"

Такой отчет можно запускать перед еженедельным обзором. CLI формирует данные, а PowerShell отвечает за сохранение. Если вывод содержит персональные или рабочие сведения, не складывайте файл в общедоступную папку.

Запуск по расписанию

Сохраните проверенные команды в файл .ps1. В Планировщике заданий создайте задачу, выберите powershell.exe или pwsh.exe и передайте аргумент -File с полным путем к сценарию. Запускайте задачу только в пользовательском сеансе: Obsidian должен иметь возможность открыть графическое приложение и подключить CLI.

Перед массовыми изменениями сделайте резервную копию или зафиксируйте состояние хранилища в Git. Команды append обычно обратимы вручную, а overwrite и пакетное создание способны быстро размножить ошибку.

Диагностика проблем

  • Команда не найдена. Повторно запустите установщик 1.12.7 или новее, включите CLI в настройках и откройте новое окно терминала.

  • Подключение зависает. Запустите Obsidian вручную и проверьте, что открыт нужный пользовательский сеанс.

  • Выбрано не то хранилище. Поставьте vault первым параметром и используйте идентификатор вместо неоднозначного имени.

  • Ошибка доступа в Windows. Не запускайте Obsidian от администратора, если терминал открыт с обычными правами. Пользователи сообщали о сбое именованного канала при несовпадении уровней привилегий.

  • Нужен сервер без интерфейса. Официальный CLI для настольного приложения не является headless-инструментом. Для серверных сценариев Obsidian предлагает отдельное решение Headless, связанное с Sync.

Что автоматизировать, а что оставить вручную

CLI хорошо подходит для однообразного ввода, отчетов, поиска и обслуживания плагинов. Он хуже подходит для операций, где решение зависит от смысла заметки. Пакетное переименование и перенос связанного графа следует сначала проверять на копии хранилища.

Для сравнения подходов к визуальной организации знаний прочитайте наш обзор Heptabase. Другой пример настройки среды Windows есть в материале о футуристическом рабочем столе.

Актуализировано: 17 июля 2026 года. CLI развивается вместе с Obsidian, поэтому перед созданием критичных сценариев сверяйте названия команд со встроенной справкой.

Источники

Комментарии

bottom of page