Obsidian CLI Bases and Bookmarks
Use this skill for Obsidian Bases and Bookmarks operations through official desktop obsidian CLI commands.
Routing contract
Use this skill when:
- the user asks to inspect or query
.base files
- the user asks to list base views or query base results in structured formats
- the user asks to create an item through a base view
- the user asks to list or add bookmarks
Do not use this skill when:
- the request is primarily note CRUD, tasks, templates, link cleanup, or history/diff workflows
- the request is plugin/theme/snippet runtime administration
- the request is Sync/Publish operations
- the request is explicitly a named one-command workflow ID (route to
obsidian-cli-workflows)
- the request is runtime diagnostics/eval/CDP workflows
Preconditions
Assume these must be true before relying on this skill:
obsidian command is installed and registered
- Obsidian desktop app is available locally
- first command may launch Obsidian if it is not running
- in Codex Desktop on macOS, direct launches may crash; use the sanitized wrapper
Codex-safe launcher
In Codex Desktop on macOS, prefer this wrapper:
script -q /dev/null /usr/local/bin/zsh -ilc 'unset __CFBundleIdentifier LaunchInstanceID XPC_SERVICE_NAME CODEX_CI CODEX_SANDBOX CODEX_SHELL; export TERM=xterm-256color; obsidian ...'
Escalate the wrapped command only when required by sandbox boundaries.
Core operating policy
- Use only documented official Bases and Bookmarks CLI commands.
- Prefer read-only discovery first for mixed flows:
bases, base:views, base:query, bookmarks.
- Use structured output (
json, csv, tsv, md, paths) whenever supported and useful.
- Treat
base:create as a mutating operation and summarize created-file side effects before executing.
- For
bookmark, require explicit target type (file, folder, search, or url) and avoid silent assumptions.
- If base file/path, view name, or bookmark target is ambiguous, stop and ask for disambiguation.
- Keep scope narrow to requested base/bookmark workflow; do not drift into unrelated note-wide edits.
- If request is outside official Bases/Bookmarks surface, say so and stop.
Risk levels
- low:
bases, base:views, base:query, bookmarks
- medium:
bookmark
- high:
base:create
Response contract
Always return:
- capability used
- risk level (
low, medium, high)
- execution mode (
direct or escalated)
- exact command(s) run or proposed
- output format used (if structured)
- side-effect summary (for mutating actions)
- files/bookmarks affected, if any
- blocking reason, if any
Command families
Bases:
bases
base:views
base:query
base:create
Bookmarks:
References
references/obsidian-cli-bases-bookmarks-playbook.md
references/limitations-and-boundaries.md
references/validation.md
references/source-links.md
1---2name: obsidian-cli-bases-and-bookmarks3description: Use this skill when the user needs official desktop Obsidian CLI Bases or Bookmarks workflows, including base discovery, view/query operations, base item creation, and bookmark management. Keep this skill separate from general note CRUD, runtime admin, Sync/Publish, and devtools diagnostics.4---56# Obsidian CLI Bases and Bookmarks78Use this skill for Obsidian Bases and Bookmarks operations through official desktop `obsidian` CLI commands.910## Routing contract1112Use this skill when:13- the user asks to inspect or query `.base` files14- the user asks to list base views or query base results in structured formats15- the user asks to create an item through a base view16- the user asks to list or add bookmarks1718Do not use this skill when:19- the request is primarily note CRUD, tasks, templates, link cleanup, or history/diff workflows20- the request is plugin/theme/snippet runtime administration21- the request is Sync/Publish operations22- the request is explicitly a named one-command workflow ID (route to `obsidian-cli-workflows`)23- the request is runtime diagnostics/eval/CDP workflows2425## Preconditions2627Assume these must be true before relying on this skill:28- `obsidian` command is installed and registered29- Obsidian desktop app is available locally30- first command may launch Obsidian if it is not running31- in Codex Desktop on macOS, direct launches may crash; use the sanitized wrapper3233## Codex-safe launcher3435In Codex Desktop on macOS, prefer this wrapper:3637```bash38script -q /dev/null /usr/local/bin/zsh -ilc 'unset __CFBundleIdentifier LaunchInstanceID XPC_SERVICE_NAME CODEX_CI CODEX_SANDBOX CODEX_SHELL; export TERM=xterm-256color; obsidian ...'39```4041Escalate the wrapped command only when required by sandbox boundaries.4243## Core operating policy44451. Use only documented official Bases and Bookmarks CLI commands.462. Prefer read-only discovery first for mixed flows: `bases`, `base:views`, `base:query`, `bookmarks`.473. Use structured output (`json`, `csv`, `tsv`, `md`, `paths`) whenever supported and useful.484. Treat `base:create` as a mutating operation and summarize created-file side effects before executing.495. For `bookmark`, require explicit target type (`file`, `folder`, `search`, or `url`) and avoid silent assumptions.506. If base file/path, view name, or bookmark target is ambiguous, stop and ask for disambiguation.517. Keep scope narrow to requested base/bookmark workflow; do not drift into unrelated note-wide edits.528. If request is outside official Bases/Bookmarks surface, say so and stop.5354## Risk levels5556- low: `bases`, `base:views`, `base:query`, `bookmarks`57- medium: `bookmark`58- high: `base:create`5960## Response contract6162Always return:63- capability used64- risk level (`low`, `medium`, `high`)65- execution mode (`direct` or `escalated`)66- exact command(s) run or proposed67- output format used (if structured)68- side-effect summary (for mutating actions)69- files/bookmarks affected, if any70- blocking reason, if any7172## Command families7374Bases:75- `bases`76- `base:views`77- `base:query`78- `base:create`7980Bookmarks:81- `bookmarks`82- `bookmark`8384## References8586- `references/obsidian-cli-bases-bookmarks-playbook.md`87- `references/limitations-and-boundaries.md`88- `references/validation.md`89- `references/source-links.md`