Obsidian Official CLI Headless

---

name: obsidian-official-cli-headless

description: Install and adapt the official Obsidian CLI for headless Linux servers by using a non-root user, Xvfb virtual display, ACL-based vault access, and an obs wrapper command. Use when the user wants the official Obsidian CLI (not notesmd-cli) on a Debian/Ubuntu-like machine without a normal desktop session, or when root/GUI/display constraints break native CLI use.

---

# Obsidian Official CLI Headless

Treat the official Obsidian CLI as a **desktop-first app adaptation problem**, not a normal CLI install.

Core rules

Fast path

1. Confirm the vault path. Default to `/root/obsidian-vault` only if the user does not specify another path.

2. Run `scripts/install_official_obsidian.sh` as root.

3. Run `scripts/configure_official_cli.sh <vault_path>` as root.

4. Run `scripts/verify_official_cli.sh [vault_path]`.

5. Report the wrapper path, active vault, verified commands, and remaining caveats.

What this skill owns

What not to do

Wrapper model

The wrapper should effectively run:

su - obsidian -c 'cd <vault> && xvfb-run -a /usr/bin/obsidian --disable-gpu ...'

That is the stable operating model on a headless host.

Verification commands

Use at minimum:

obs help
obs vault
obs daily:path
obs daily:append content="skill verification"
obs daily:read
obs search query="skill verification"

References

Report format

Keep the result short: