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:
basesbase:viewsbase:querybase:create
Bookmarks:
References
references/obsidian-cli-bases-bookmarks-playbook.mdreferences/limitations-and-boundaries.mdreferences/validation.mdreferences/source-links.md
Source: hashgraph-online/awesome-codex-plugins → plugins/greg-asher/codex-obsidian/skills/obsidian-cli-bases-and-bookmarks/SKILL.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---5
6
7# Obsidian CLI Bases and Bookmarks
8
9Use this skill for Obsidian Bases and Bookmarks operations through official desktop `obsidian` CLI commands.
10
11## Routing contract
12
13Use this skill when:
14- the user asks to inspect or query `.base` files
15- the user asks to list base views or query base results in structured formats
16- the user asks to create an item through a base view
17- the user asks to list or add bookmarks
18
19Do not use this skill when:
20- the request is primarily note CRUD, tasks, templates, link cleanup, or history/diff workflows
21- the request is plugin/theme/snippet runtime administration
22- the request is Sync/Publish operations
23- the request is explicitly a named one-command workflow ID (route to `obsidian-cli-workflows`)
24- the request is runtime diagnostics/eval/CDP workflows
25
26## Preconditions
27
28Assume these must be true before relying on this skill:
29- `obsidian` command is installed and registered
30- Obsidian desktop app is available locally
31- first command may launch Obsidian if it is not running
32- in Codex Desktop on macOS, direct launches may crash; use the sanitized wrapper
33
34## Codex-safe launcher
35
36In Codex Desktop on macOS, prefer this wrapper:
37
38```bash
39script -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 ...'
40```
41
42Escalate the wrapped command only when required by sandbox boundaries.
43
44## Core operating policy
45
461. Use only documented official Bases and Bookmarks CLI commands.
472. Prefer read-only discovery first for mixed flows: `bases`, `base:views`, `base:query`, `bookmarks`.
483. Use structured output (`json`, `csv`, `tsv`, `md`, `paths`) whenever supported and useful.
494. Treat `base:create` as a mutating operation and summarize created-file side effects before executing.
505. For `bookmark`, require explicit target type (`file`, `folder`, `search`, or `url`) and avoid silent assumptions.
516. If base file/path, view name, or bookmark target is ambiguous, stop and ask for disambiguation.
527. Keep scope narrow to requested base/bookmark workflow; do not drift into unrelated note-wide edits.
538. If request is outside official Bases/Bookmarks surface, say so and stop.
54
55## Risk levels
56
57- low: `bases`, `base:views`, `base:query`, `bookmarks`
58- medium: `bookmark`
59- high: `base:create`
60
61## Response contract
62
63Always return:
64- capability used
65- risk level (`low`, `medium`, `high`)
66- execution mode (`direct` or `escalated`)
67- exact command(s) run or proposed
68- output format used (if structured)
69- side-effect summary (for mutating actions)
70- files/bookmarks affected, if any
71- blocking reason, if any
72
73## Command families
74
75Bases:
76- `bases`
77- `base:views`
78- `base:query`
79- `base:create`
80
81Bookmarks:
82- `bookmarks`
83- `bookmark`
84
85## References
86
87- `references/obsidian-cli-bases-bookmarks-playbook.md`
88- `references/limitations-and-boundaries.md`
89- `references/validation.md`
90- `references/source-links.md`
91
92---
93
94**Source:** [`hashgraph-online/awesome-codex-plugins`](https://github.com/hashgraph-online/awesome-codex-plugins) → `plugins/greg-asher/codex-obsidian/skills/obsidian-cli-bases-and-bookmarks/SKILL.md`
hashgraph-online