К основному содержанию
скилл CX Codex

obsidian-headless — скилл для Claude Code: что делает и как установить

Скилл obsidian-headless для Claude Code запускает синхронизацию и публикацию хранилищ Obsidian через терминал без графического приложения. Он выполняется на сервере, в CI и в песочнице.

MIT 1 200 установок ★ 53 395 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add obsidianmd/obsidian-skills --skill obsidian-headless -a claude-code
Открыть на GitHub

Что делает obsidian-headless

Инструмент управляет Obsidian Sync и Obsidian Publish из командной строки с помощью утилиты ob. Скрипт требует наличия Node.js версии 22 или новее, а также активной подписки на сервисы синхронизации и публикации.

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

Для работы утилиты нужна команда npm install -g obsidian-headless, если пакет отсутствует в системе. Учетные данные вводятся через команду в терминале, а для шифрования доступны стандартные ключи.

Какие задачи решает

  • синхронизировать хранилище Obsidian на сервере через терминал
  • опубликовать заметки Obsidian без графического приложения
  • настроить параметры синхронизации и исключения папок
  • запустить непрерывную синхронизацию хранилища в CI

Примеры запросов агенту

  • Запусти синхронизацию хранилища через ob sync --path ~/vaults/research
  • Опубликуй сайт Obsidian с флагом --yes
  • Проверь статус синхронизации хранилища через ob sync-status

Как установить obsidian-headless

1Через Skills CLI (Vercel)

npx skills add obsidianmd/obsidian-skills --skill obsidian-headless -a claude-code

2Вручную: положить файлы

~/.claude/skills/obsidian-headless/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/obsidian-headless/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об obsidian-headless

Как установить obsidian-headless в Claude Code?

Выполни команду npx skills add obsidianmd/obsidian-skills --skill obsidian-headless -a claude-code, а затем обратись к файлу ~/.claude/skills/obsidian-headless/SKILL.md.

Что делает obsidian-headless?

Скилл управляет синхронизацией и публикацией хранилищ Obsidian из командной строки без использования десктопного приложения.

Что нужно для работы obsidian-headless?

Для работы требуются Node.js версии 22 или новее, установленный пакет obsidian-headless и активная подписка на Obsidian Sync или Publish.

Исходный текст

SKILL.md · MIT
---
name: obsidian-headless
description: Sync and publish Obsidian vaults from the command line with Obsidian Headless (`ob`), without the desktop app. Use when the user wants to set up or run Obsidian Sync or Obsidian Publish on a server, in CI, or from a terminal, or change a vault's Sync or Publish settings.
---

# Obsidian Headless

Use Obsidian Headless (`ob`) to run Obsidian Sync and Obsidian Publish from the command line. It doesn't need the desktop app, so it works on servers, in CI, and in sandboxes. It's in open beta. Docs: https://help.obsidian.md/headless

`ob` only syncs and publishes files. To read or change notes without the app, edit the files directly and follow the obsidian-markdown skill. To control a running desktop app, use the obsidian-cli skill.

## Before using ob

Check availability with `ob --help`. If it is missing, explain that Obsidian Headless requires Node.js 22 or later and offer installation with `npm install -g obsidian-headless`. Run `ob <command> --help` for a command's options.

Sync and Publish each need an active subscription on the user's account.

Most commands accept `--json` for machine-readable output.

## Log in

`ob login` prints the account when already logged in. Otherwise it prompts for email, password, and a 2FA code, so ask the user to run it in their own terminal. Don't ask for their password or pass it with `--password`. `ob logout` clears the stored credentials.

## Vault paths

Commands act on the vault in the current directory, or the one given with `--path`. Pass `--path` so the target is explicit. Before a command that changes remote state, confirm the vault, site, and path from list or status output.

## Sync

Don't use the desktop app's Sync and Headless Sync for the same vault on the same device, because they cause conflicts. Ask the user to back up the vault folder before the first sync.

```bash
ob sync-list-remote                                  # remote vaults, including shared ones
ob sync-list-local                                   # vaults set up on this machine
ob sync-setup --vault "Research" --path ~/vaults/research
ob sync --path ~/vaults/research                     # sync once
ob sync --path ~/vaults/research --continuous        # keep syncing as files change
ob sync-status --path ~/vaults/research
ob sync-unlink --path ~/vaults/research              # disconnect and remove stored credentials
```

`--vault` takes a remote vault's name or ID. For an end-to-end encrypted vault, `sync-setup` prompts for the encryption password, so let the user enter it. Set `--device-name` to label this machine in version history.

`--continuous` runs until stopped, so start it in the background or as a service.

`ob sync-create-remote --name "Research"` creates a remote vault. Add `--encryption e2ee` for end-to-end encryption or `--encryption standard` for managed encryption.

### Sync settings

`ob sync-config --path <vault>` prints the vault's settings. Change them with:

- `--mode bidirectional|pull-only|mirror-remote`. `pull-only` ignores local changes and `mirror-remote` reverts them, so confirm before setting either.
- `--conflict-strategy merge|conflict`
- `--excluded-folders "Archive,Templates"`
- `--file-types image,audio,video,pdf,unsupported` for the attachment types to sync.
- `--configs` for the settings categories to sync, e.g. `app,appearance,core-plugin`.
- `--config-dir` when the vault's configuration folder isn't `.obsidian`.

An empty string clears a list option, e.g. `--excluded-folders ""`.

## Publish

```bash
ob publish-list-sites
ob publish-setup --site my-notes --path ~/vaults/research
ob publish --path ~/vaults/research --dry-run
ob publish --path ~/vaults/research --yes
```

`ob publish` includes only notes with `publish: true` in their properties. `--all` includes every file, so use it only when the user asks. Run `--dry-run` first and show the user the changes. Without `--yes`, `ob publish` waits for confirmation, so pass `--yes` once the user approves or for an unattended job they set up.

`ob publish-create-site --slug my-notes` creates a site at `publish.obsidian.md/my-notes`.

Run these with no options to print the current settings:

- `ob publish-config` sets folders to include or exclude with `--includes` and `--excludes`.
- `ob publish-site-options` sets the site name, home page, navigation, theme, and other display options. Run `ob publish-site-options --help` for the full list.

`ob publish-unlink` disconnects the vault from its site.

© obsidianmd · MIT · obsidianmd/obsidian-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
obsidian openclaw Подключает официальный obsidian CLI для чтения, поиска, создания и редактирования заметок в хранилище Obsidian. CX Codex +1 6 400установок obsidian-organizer Agents365-ai Скилл obsidian-organizer для Claude Code и Codex. Раскладывает заметки по папкам хранилища Obsidian и наводит порядок в структуре, когда входящие копятся в корне и нельзя ломать связи между файлами. CX Codex +1 1 900установок obsidian-markdown AgriciDaniel Скилл obsidian-markdown объясняет, черновики и проверяет синтаксис Obsidian Flavored Markdown: свойства, wikilinks, вставки, callouts, теги, блоки, математику и Mermaid. CX Codex +1 593установок obsidian-kb-artifacts Galaxy-Dawn Скилл obsidian-kb-artifacts для Claude Code и Codex работает с форматированием Obsidian и производными артефактами: вики-ссылками, таблицами реестра, canvas-файлами, базами и восстановлением связей. CX Codex +1 328установок obsidian-notes-creator szeyu Скилл obsidian-notes-creator создаёт, дополняет и проверяет учебные заметки Obsidian по лекциям, учебникам и PDF-файлам. Форматирует конспекты с LaTeX-формулами, диаграммами Mermaid и подробными решениями задач. CX Codex +1 689установок obsidian-bases AgriciDaniel Скилл obsidian-bases помогает составлять, проверять и редактировать файлы .base в Obsidian с фильтрами, формулами и разными типами представлений. CX Codex +1 547установок

Из того же набора5

Спонсоры проекта

Компании, которые помогают держать аналитику открытой