Obsidian CLI Workspace and Navigation
Use this skill for Obsidian workspace and navigation operations through official desktop obsidian CLI commands.
Routing contract
Use this skill when:
- the user asks about vault metadata or vault listing
- the user asks to inspect or change workspace layout state
- the user asks about tabs, recent files, or opening views/files for navigation
- the user asks for random/unique note navigation helpers
- the user asks to open a URL in Obsidian web viewer
- the user asks for word/character counts
Do not use this skill when:
- the request is primarily note CRUD, tasks, properties, templates, links, or history/diff
- the request is plugin/theme/snippet administration
- the request is Sync or Publish management
- the request is explicitly a named one-command workflow ID (route to
obsidian-cli-workflows)
- the request is runtime diagnostics, DOM/CSS inspection, screenshot capture, eval, or CDP
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 "${CODEX_OBSIDIAN_ZSH_PATH:-/usr/local/bin/zsh}" -ilc 'unset __CFBundleIdentifier LaunchInstanceID XPC_SERVICE_NAME CODEX_CI CODEX_SANDBOX CODEX_SHELL; export TERM=xterm-256color; obsidian ...'
Set CODEX_OBSIDIAN_ZSH_PATH to override the default /usr/local/bin/zsh path. The override must be an absolute path to a Zsh-compatible executable.
Escalate the wrapped command only when required by sandbox boundaries.
Core operating policy
- Use only documented official workspace/navigation CLI commands.
- Prefer read-only inspection first for mixed flows:
vault, vaults, workspace, workspaces, tabs, recents, wordcount.
- Treat workspace layout mutations as high-impact operations (
workspace:save, workspace:load, workspace:delete).
- For
tab:open and open, require explicit target intent when both file and view options are plausible.
vault:open is not currently treated as part of this skill's owned command set in this plugin release.
- For
web url=..., require explicit URL target and avoid silent URL construction.
- Summarize side effects before mutating workspace state.
- If a request is outside official workspace/navigation surface, say so and stop.
Risk levels
- low:
vault, vaults, workspace, workspaces, tabs, recents, random, random:read, wordcount
- medium:
open, tab:open, unique, web
- high:
workspace:save, workspace:load, workspace:delete
Response contract
Always return:
- capability used
- risk level (
low, medium, high)
- execution mode (
direct or escalated)
- exact command(s) run or proposed
- side-effect summary (for workspace mutations)
- files/views/workspaces affected, if any
- blocking reason, if any
Command families
Vault:
Workspace and tabs:
workspace
workspaces
workspace:save
workspace:load
workspace:delete
tabs
tab:open
recents
Navigation and utility:
open
random
random:read
unique
web
wordcount
References
references/obsidian-cli-workspace-navigation-playbook.md
references/limitations-and-boundaries.md
references/validation.md
references/source-links.md
1---2name: obsidian-cli-workspace-and-navigation3description: Use this skill when the user needs official desktop Obsidian CLI workspace, vault, tab, navigation, and utility operations, including workspace save/load/delete, tab and recent-file handling, vault info/listing, random/unique note navigation helpers, web viewer, and wordcount. Keep this skill separate from note CRUD/tasks/properties/history, runtime admin, devtools diagnostics, and Sync/Publish operations.4metadata:5 source: https://skillmd.com/skills/hashgraph-online/obsidian-cli-workspace-and-navigation6---78# Obsidian CLI Workspace and Navigation910Use this skill for Obsidian workspace and navigation operations through official desktop `obsidian` CLI commands.1112## Routing contract1314Use this skill when:15- the user asks about vault metadata or vault listing16- the user asks to inspect or change workspace layout state17- the user asks about tabs, recent files, or opening views/files for navigation18- the user asks for random/unique note navigation helpers19- the user asks to open a URL in Obsidian web viewer20- the user asks for word/character counts2122Do not use this skill when:23- the request is primarily note CRUD, tasks, properties, templates, links, or history/diff24- the request is plugin/theme/snippet administration25- the request is Sync or Publish management26- the request is explicitly a named one-command workflow ID (route to `obsidian-cli-workflows`)27- the request is runtime diagnostics, DOM/CSS inspection, screenshot capture, eval, or CDP2829## Preconditions3031Assume these must be true before relying on this skill:32- `obsidian` command is installed and registered33- Obsidian desktop app is available locally34- first command may launch Obsidian if it is not running35- in Codex Desktop on macOS, direct launches may crash; use the sanitized wrapper3637## Codex-safe launcher3839In Codex Desktop on macOS, prefer this wrapper:4041```bash42script -q /dev/null "${CODEX_OBSIDIAN_ZSH_PATH:-/usr/local/bin/zsh}" -ilc 'unset __CFBundleIdentifier LaunchInstanceID XPC_SERVICE_NAME CODEX_CI CODEX_SANDBOX CODEX_SHELL; export TERM=xterm-256color; obsidian ...'43```4445Set `CODEX_OBSIDIAN_ZSH_PATH` to override the default `/usr/local/bin/zsh` path. The override must be an absolute path to a Zsh-compatible executable.4647Escalate the wrapped command only when required by sandbox boundaries.4849## Core operating policy50511. Use only documented official workspace/navigation CLI commands.522. Prefer read-only inspection first for mixed flows: `vault`, `vaults`, `workspace`, `workspaces`, `tabs`, `recents`, `wordcount`.533. Treat workspace layout mutations as high-impact operations (`workspace:save`, `workspace:load`, `workspace:delete`).544. For `tab:open` and `open`, require explicit target intent when both file and view options are plausible.555. `vault:open` is not currently treated as part of this skill's owned command set in this plugin release.566. For `web url=...`, require explicit URL target and avoid silent URL construction.577. Summarize side effects before mutating workspace state.588. If a request is outside official workspace/navigation surface, say so and stop.5960## Risk levels6162- low: `vault`, `vaults`, `workspace`, `workspaces`, `tabs`, `recents`, `random`, `random:read`, `wordcount`63- medium: `open`, `tab:open`, `unique`, `web`64- high: `workspace:save`, `workspace:load`, `workspace:delete`6566## Response contract6768Always return:69- capability used70- risk level (`low`, `medium`, `high`)71- execution mode (`direct` or `escalated`)72- exact command(s) run or proposed73- side-effect summary (for workspace mutations)74- files/views/workspaces affected, if any75- blocking reason, if any7677## Command families7879Vault:80- `vault`81- `vaults`8283Workspace and tabs:84- `workspace`85- `workspaces`86- `workspace:save`87- `workspace:load`88- `workspace:delete`89- `tabs`90- `tab:open`91- `recents`9293Navigation and utility:94- `open`95- `random`96- `random:read`97- `unique`98- `web`99- `wordcount`100101## References102103- `references/obsidian-cli-workspace-navigation-playbook.md`104- `references/limitations-and-boundaries.md`105- `references/validation.md`106- `references/source-links.md`