obsidian-headless
An agent skill from the Obsidian team's obsidianmd/obsidian-skills repository for Obsidian Headless, the ob command-line tool that runs Obsidian Sync and Obsidian Publish without the desktop app, for example on a server or in a CI job.
What the skill teaches
An agent skill from the Obsidian team's obsidianmd/obsidian-skills repository for Obsidian Headless, the ob command-line tool that runs Obsidian Sync and Obsidian Publish without the desktop app, for example on a server or in a CI job. It guides the agent through installing the tool with npm on Node.js 22 or later, leaving sign-in to the user, listing and linking remote vaults, running single or continuous syncs, changing sync settings, and previewing then publishing a site. Sync and Publish each require an active Obsidian subscription, and the skill says Headless itself is in open beta.
Capabilities
- Set up Obsidian Sync for a vault from the command line
- Run one-off or continuous vault syncs
- Change a vault's sync mode, exclusions and file types
- Preview and publish an Obsidian Publish site
About
- Publisher
- Obsidian
- Tool
- Obsidian
Works with
Install
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Obsidian | |
| Publisher | Obsidian | source |
| Official status | Officialrepository is in Obsidian's own GitHub organisation; plugin manifest names Obsidian as author | source |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Code, Cursor, Codex | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 11, 202652,433 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository |
More from Obsidian
7 skills
- defuddle (Skill)
- json-canvas (Skill)
- knap (Skill)
- obsidian-bases (Skill)
- obsidian-cli (Skill)
- obsidian-markdown (Skill)
Badge for your README
Maintain this project? Add a badge that links to this page.
[](https://kitbay.app/skills/obsidian-headless/)
Sources
- GitHub repositorygithub.com/obsidianmd/obsidian-skills · Backs: AI clientsNov 12, 2026
- Skill file (SKILL.md)github.com/obsidianmd/obsidian-skillsNov 14, 2026
- GitHub repositorygithub.com/obsidianmd/obsidian-skills · Backs: Official status, Activity, LicenceNov 14, 2026
- Licence file (LICENSE)github.com/obsidianmd/obsidian-skills · Backs: LicenceNov 12, 2026
- Web pageraw.githubusercontent.com · Backs: PublisherNov 12, 2026
- Folder in the repository (obsidian-headless)github.com/obsidianmd/obsidian-skills · Backs: Includes scriptsNov 14, 2026