Obsidian CLIs

CLIs here means two terminal interfaces: the Obsidian app CLI (obsidian, primary) and notesmd-cli (filesystem fallback when obsidian is not available). There is no separate invocation mode—pick the binary that exists in the environment.

Which binary to use

1. If obsidian is on PATH, use it for all workflows below (richer surface: links, Bases, tasks, plugin dev).
2. If obsidian is missing but notesmd-cli is on PATH, follow notesmd-fallback.md for headless vault operations.
3. If neither is available, say so and fall back to direct file edits, MCP, or other vault tools the user provides.

CLI availability

Before relying on either tool, confirm install with command -v obsidian and command -v notesmd-cli (or which) when the environment is unknown. Do not assume either binary is present.

If sandboxed obsidian cannot find the running app, retry outside the sandbox before falling back.

Obsidian app CLI