Git Backed Obsidian CLI Workflows

---

name: git-backed-obsidian-cli-workflows

description: Use the official Obsidian CLI for note workflows in a Git-backed vault, including search, read, links/backlinks-style queries, daily-note operations, and lightweight note writes that auto-sync after successful write operations. Use when the official Obsidian CLI is already installed and usable on any supported environment, and the task is about querying or updating notes in an Obsidian vault with Git-backed backup behavior.

---

# Git Backed Obsidian CLI Workflows

Use the official Obsidian CLI as the primary workflow surface. Treat Git sync as a write-only follow-up, not part of read/query operations.

Core rules

Environment model

This skill is **not server-only**. Use it anywhere the official Obsidian CLI is already available:

If the environment is a headless server and the official CLI is not yet usable, use `obsidian-official-cli-headless` first. That skill handles server adaptation and installation. This skill handles the day-to-day note workflows after the CLI works.

Fast path

1. Classify the request as either:

- read/query

- write/update

2. For read/query tasks, use the official CLI directly.

3. For write/update tasks, use the official CLI first, then run backup/sync.

4. Use fallback file writing only for supported write workflows when CLI writing is unavailable.

5. Report the target note/path, whether CLI or fallback was used, and whether sync succeeded.

Common read/query commands

Prefer commands such as:

obs search query="..."
obs read file="..."
obs daily:read
obs links file="..."
obs outline file="..."
obs tags
obs tasks daily
obs vault

Use exact commands supported by the installed official CLI.

Common write/update commands

Prefer commands such as:

obs daily
obs daily:append content="..."
obs create name="..." content="..."

After a successful write, run the backup script.

Bundled scripts

Use `scripts/notes_workflow.py` when you need a deterministic wrapper for:

Use `scripts/backup.sh` as the default post-write Git sync path for this skill.

References

What not to do

What to report

Keep the result minimal: