Fix command-reference: correct 6 tested inaccuracies, add undiscovered commands

- files: remove format=json (returns plain text, not JSON)
- search matches: note it does not return match context in v1.12
- search format=json: clarify it returns array of path strings
- tasks: note that no-args returns all tasks (same as tasks all) in v1.12
- plugins versions: note version numbers only shown for community plugins
- plugin:uninstall: add undiscovered command
- themes versions: add undiscovered subcommand, remove nonexistent install/switch
- template:insert: clarify it targets the active Obsidian UI file, not a path
- dev:screenshot: note path must be vault-relative (absolute paths silently fail)
- dev:debug on/off: add undiscovered commands required before dev:console
- dev:console: note requires dev:debug on first
- jq example: fix .[].path -> .[] (search returns strings, not objects)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "obsidian-cli",
   "description": "Interact with Obsidian vaults using the official Obsidian CLI (v1.12+). Read, create, append, search, and manage notes, daily notes, properties, tags, tasks, bookmarks, templates, themes, sync, plugins, and links — all from the terminal.",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "author": {
     "name": "pablo-mano"
   },

README.md

@@ -94,17 +94,30 @@ Add to your project's `.claude/settings.json`:
 
 Cursor has a native skills system (launched Feb 2026) that is directly compatible with the `SKILL.md` format — no rules file needed.
 
-**Option A — GitHub install (recommended):**
-1. Open Cursor Settings → Rules
-2. Click **Add Rule** → **Remote Rule (GitHub)**
-3. Paste `https://github.com/pablo-mano/Obsidian-CLI-skill`
-4. Done — the skill auto-triggers on Obsidian-related tasks.
+In a terminal:
 
-**Option B — Local copy:**
-1. Clone or download this repo
-2. Copy the folder into your project: `.cursor/skills/obsidian-cli/`
-   (or globally: `~/.cursor/skills/obsidian-cli/`)
-3. Cursor picks it up automatically — no restart needed.
+```bash
+git clone --depth 1 https://github.com/pablo-mano/Obsidian-CLI-skill /tmp/Obsidian-CLI-skill
+mkdir -p ~/.cursor/skills
+cp -r /tmp/Obsidian-CLI-skill/skills/obsidian-cli ~/.cursor/skills/obsidian-cli
+rm -rf /tmp/Obsidian-CLI-skill
+```
+
+Cursor picks it up automatically — no restart needed.
+
+---
+
+### GitHub Copilot (VS Code)
+
+Copilot supports [custom instructions](https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot) via repository files:
+
+**Option A — Repository-wide (recommended):**
+1. Create `.github/copilot-instructions.md` in your repo.
+2. Paste the body of `SKILL.md` into the file.
+
+**Option B — Path-scoped:**
+1. Create `.github/instructions/obsidian-cli.instructions.md`
+2. Add frontmatter `applyTo: "**/*"` then paste the `SKILL.md` body.
 
 ---
 
@@ -147,20 +160,6 @@ Openclaw loads skills from the `skills/` directory at the project root using the
 
 ---
 
-### GitHub Copilot (VS Code)
-
-Copilot supports [custom instructions](https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot) via repository files:
-
-**Repository-wide** (applies to all files):
-1. Create `.github/copilot-instructions.md` in your repo.
-2. Paste the body of `SKILL.md` into the file.
-
-**Path-scoped** (optional alternative):
-1. Create `.github/instructions/obsidian-cli.instructions.md`
-2. Add frontmatter `applyTo: "**/*"` then paste the `SKILL.md` body.
-
----
-
 ### Any Other LLM Agent or Assistant
 
 `SKILL.md` is a plain Markdown document. For any agent that supports custom system prompts or instructions:

plugins/obsidian-cli/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "obsidian-cli",
   "description": "Interact with Obsidian vaults using the official Obsidian CLI (v1.12+). Read, create, append, search, and manage notes, daily notes, properties, tags, tasks, bookmarks, templates, themes, sync, plugins, and links — all from the terminal.",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "author": {
     "name": "pablo-mano"
   },

plugins/obsidian-cli/skills/obsidian-cli/references/command-reference.md

@@ -83,7 +83,6 @@ obsidian files                       # List all files in vault
 obsidian files ext=md                # Filter by extension
 obsidian files folder="subfolder"    # Files in specific folder
 obsidian files total                 # Just the file count
-obsidian files format=json           # JSON output
 obsidian folders                     # List all folders
 obsidian file path="folder/note.md"  # File info (size, created, modified dates)
 ```
@@ -116,8 +115,8 @@ Full-text search across the vault.
 obsidian search query="search text"
 obsidian search query="text" path="folder"         # Scope to folder
 obsidian search query="text" limit=10               # Limit results
-obsidian search query="text" format=json            # JSON output
-obsidian search query="text" matches                # Include match context/snippets
+obsidian search query="text" format=json            # JSON output (array of file paths)
+obsidian search query="text" matches                # Accepted but returns file paths only
 obsidian search query="text" case                   # Case-sensitive search
 ```
 
@@ -125,8 +124,8 @@ obsidian search query="text" case                   # Case-sensitive search
 - `query=` — Search term (required)
 - `path=` — Restrict search to a folder
 - `limit=` — Maximum number of results
-- `format=json` — Machine-readable JSON output
-- `matches` — Show matching line context
+- `format=json` — Returns a JSON array of matching file paths: `["folder/note.md", ...]`
+- `matches` — Flag accepted by the CLI but does not return match context/snippets in v1.12
 - `case` — Enable case-sensitive matching
 
 ---
@@ -196,13 +195,15 @@ Query and manage checkbox tasks across the vault.
 ### Querying Tasks
 
 ```bash
-obsidian tasks                         # All incomplete tasks
+obsidian tasks                         # All tasks (same as tasks all in v1.12)
 obsidian tasks all                     # All tasks (complete + incomplete)
 obsidian tasks done                    # Only completed tasks
 obsidian tasks path="note.md"          # Tasks in a specific file
 obsidian tasks daily                   # Tasks in today's daily note
 ```
 
+> **Note:** In v1.12, `tasks` with no arguments returns all tasks (complete + incomplete), identical to `tasks all`. Filtering to incomplete-only is not currently supported without post-processing (e.g. pipe to `grep "\[ \]"`).
+
 ### Toggling Task Status
 
 ```bash
@@ -248,14 +249,16 @@ Work with note templates (requires Templates or Templater plugin).
 obsidian templates                                      # List available templates
 obsidian template:read name="weekly-review"             # Read template content
 obsidian template:read name="weekly-review" resolve title="My Note"  # Render with variables
-obsidian template:insert name="weekly-review"           # Insert template into active file
+obsidian template:insert name="weekly-review"           # Insert template into the active Obsidian UI file
 ```
 
 **Parameters:**
 - `name=` — Template name (without path prefix or extension)
-- `resolve` — Process template variables
+- `resolve` — Process template variables (`{{date}}`, `{{title}}`, etc.)
 - Title and other variables can be passed as `key=value` for template rendering.
 
+> **Note:** `template:insert` inserts into whichever file is currently active in the Obsidian UI — it does not accept a `path=` parameter. To create a new file from a template, use `obsidian create path="..." template="..."` instead.
+
 ---
 
 ## Plugins
@@ -263,15 +266,18 @@ obsidian template:insert name="weekly-review"           # Insert template into a
 Manage community and core plugins.
 
 ```bash
-obsidian plugins                       # List all installed plugins
-obsidian plugins:enabled               # Only enabled plugins
-obsidian plugins versions              # Plugins with version numbers
-obsidian plugin:enable id="canvas"     # Enable a plugin
-obsidian plugin:disable id="canvas"    # Disable a plugin
-obsidian plugin:install id="dataview"  # Install from community plugins
-obsidian plugin:reload id="my-plugin"  # Reload a plugin (useful for dev)
+obsidian plugins                         # List all plugins (core + community)
+obsidian plugins:enabled                 # Only enabled plugins
+obsidian plugins versions                # Plugins with version numbers (community only)
+obsidian plugin:enable id="canvas"       # Enable a plugin
+obsidian plugin:disable id="canvas"      # Disable a plugin
+obsidian plugin:install id="dataview"    # Install from community plugins
+obsidian plugin:uninstall id="dataview"  # Uninstall a community plugin
+obsidian plugin:reload id="my-plugin"    # Reload a plugin (useful for dev)
 ```
 
+> **Note:** `plugins versions` only shows version numbers for community plugins. Core (built-in) plugins share Obsidian's version and display blank version fields.
+
 ---
 
 ## Sync
@@ -296,11 +302,10 @@ obsidian sync:deleted                           # List files deleted via sync
 Manage appearance themes.
 
 ```bash
-obsidian themes                        # List available/installed themes
+obsidian themes                        # List installed themes
+obsidian themes versions               # List installed themes with version numbers
 ```
 
-Use `obsidian themes --help` for additional subcommands related to theme management (install, switch, etc.).
-
 ---
 
 ## Developer
@@ -310,10 +315,10 @@ Debugging and development tools.
 ### Screenshots
 
 ```bash
-obsidian dev:screenshot path="screenshot.png"
+obsidian dev:screenshot path="folder/screenshot.png"
 ```
 
-Takes a screenshot of the Obsidian window and saves it.
+Takes a screenshot of the Obsidian window and saves it. **Path must be vault-relative** — absolute filesystem paths are silently ignored.
 
 ### JavaScript Evaluation
 
@@ -327,10 +332,14 @@ Executes arbitrary JavaScript in the Obsidian app context. Has access to the ful
 ### Console & Errors
 
 ```bash
-obsidian dev:console limit=20          # Recent console output
-obsidian dev:errors                    # Recent error messages
+obsidian dev:debug on              # Start capturing console output (required before dev:console)
+obsidian dev:debug off             # Stop capturing console output
+obsidian dev:console limit=20     # Recent console output (requires dev:debug on first)
+obsidian dev:errors                # Recent error messages
 ```
 
+> **Note:** `dev:console` will return an error unless `dev:debug on` has been run first in the current session.
+
 ---
 
 ## Vault & System
@@ -369,9 +378,11 @@ obsidian tag name="urgent" | while read -r note; do
 done
 
 # Export search results as JSON and process with jq
-obsidian search query="meeting" format=json | jq '.[].path'
+# format=json returns an array of file path strings: ["folder/note.md", ...]
+obsidian search query="meeting" format=json | jq '.[]'
 
-# Filter console errors
+# Filter console errors (requires dev:debug on first)
+obsidian dev:debug on
 obsidian dev:console limit=50 | grep -i error
 ```
 

skills/obsidian-cli/references/command-reference.md

@@ -83,7 +83,6 @@ obsidian files                       # List all files in vault
 obsidian files ext=md                # Filter by extension
 obsidian files folder="subfolder"    # Files in specific folder
 obsidian files total                 # Just the file count
-obsidian files format=json           # JSON output
 obsidian folders                     # List all folders
 obsidian file path="folder/note.md"  # File info (size, created, modified dates)
 ```
@@ -116,8 +115,8 @@ Full-text search across the vault.
 obsidian search query="search text"
 obsidian search query="text" path="folder"         # Scope to folder
 obsidian search query="text" limit=10               # Limit results
-obsidian search query="text" format=json            # JSON output
-obsidian search query="text" matches                # Include match context/snippets
+obsidian search query="text" format=json            # JSON output (array of file paths)
+obsidian search query="text" matches                # Accepted but returns file paths only
 obsidian search query="text" case                   # Case-sensitive search
 ```
 
@@ -125,8 +124,8 @@ obsidian search query="text" case                   # Case-sensitive search
 - `query=` — Search term (required)
 - `path=` — Restrict search to a folder
 - `limit=` — Maximum number of results
-- `format=json` — Machine-readable JSON output
-- `matches` — Show matching line context
+- `format=json` — Returns a JSON array of matching file paths: `["folder/note.md", ...]`
+- `matches` — Flag accepted by the CLI but does not return match context/snippets in v1.12
 - `case` — Enable case-sensitive matching
 
 ---
@@ -196,13 +195,15 @@ Query and manage checkbox tasks across the vault.
 ### Querying Tasks
 
 ```bash
-obsidian tasks                         # All incomplete tasks
+obsidian tasks                         # All tasks (same as tasks all in v1.12)
 obsidian tasks all                     # All tasks (complete + incomplete)
 obsidian tasks done                    # Only completed tasks
 obsidian tasks path="note.md"          # Tasks in a specific file
 obsidian tasks daily                   # Tasks in today's daily note
 ```
 
+> **Note:** In v1.12, `tasks` with no arguments returns all tasks (complete + incomplete), identical to `tasks all`. Filtering to incomplete-only is not currently supported without post-processing (e.g. pipe to `grep "\[ \]"`).
+
 ### Toggling Task Status
 
 ```bash
@@ -248,14 +249,16 @@ Work with note templates (requires Templates or Templater plugin).
 obsidian templates                                      # List available templates
 obsidian template:read name="weekly-review"             # Read template content
 obsidian template:read name="weekly-review" resolve title="My Note"  # Render with variables
-obsidian template:insert name="weekly-review"           # Insert template into active file
+obsidian template:insert name="weekly-review"           # Insert template into the active Obsidian UI file
 ```
 
 **Parameters:**
 - `name=` — Template name (without path prefix or extension)
-- `resolve` — Process template variables
+- `resolve` — Process template variables (`{{date}}`, `{{title}}`, etc.)
 - Title and other variables can be passed as `key=value` for template rendering.
 
+> **Note:** `template:insert` inserts into whichever file is currently active in the Obsidian UI — it does not accept a `path=` parameter. To create a new file from a template, use `obsidian create path="..." template="..."` instead.
+
 ---
 
 ## Plugins
@@ -263,15 +266,18 @@ obsidian template:insert name="weekly-review"           # Insert template into a
 Manage community and core plugins.
 
 ```bash
-obsidian plugins                       # List all installed plugins
-obsidian plugins:enabled               # Only enabled plugins
-obsidian plugins versions              # Plugins with version numbers
-obsidian plugin:enable id="canvas"     # Enable a plugin
-obsidian plugin:disable id="canvas"    # Disable a plugin
-obsidian plugin:install id="dataview"  # Install from community plugins
-obsidian plugin:reload id="my-plugin"  # Reload a plugin (useful for dev)
+obsidian plugins                         # List all plugins (core + community)
+obsidian plugins:enabled                 # Only enabled plugins
+obsidian plugins versions                # Plugins with version numbers (community only)
+obsidian plugin:enable id="canvas"       # Enable a plugin
+obsidian plugin:disable id="canvas"      # Disable a plugin
+obsidian plugin:install id="dataview"    # Install from community plugins
+obsidian plugin:uninstall id="dataview"  # Uninstall a community plugin
+obsidian plugin:reload id="my-plugin"    # Reload a plugin (useful for dev)
 ```
 
+> **Note:** `plugins versions` only shows version numbers for community plugins. Core (built-in) plugins share Obsidian's version and display blank version fields.
+
 ---
 
 ## Sync
@@ -296,11 +302,10 @@ obsidian sync:deleted                           # List files deleted via sync
 Manage appearance themes.
 
 ```bash
-obsidian themes                        # List available/installed themes
+obsidian themes                        # List installed themes
+obsidian themes versions               # List installed themes with version numbers
 ```
 
-Use `obsidian themes --help` for additional subcommands related to theme management (install, switch, etc.).
-
 ---
 
 ## Developer
@@ -310,10 +315,10 @@ Debugging and development tools.
 ### Screenshots
 
 ```bash
-obsidian dev:screenshot path="screenshot.png"
+obsidian dev:screenshot path="folder/screenshot.png"
 ```
 
-Takes a screenshot of the Obsidian window and saves it.
+Takes a screenshot of the Obsidian window and saves it. **Path must be vault-relative** — absolute filesystem paths are silently ignored.
 
 ### JavaScript Evaluation
 
@@ -327,10 +332,14 @@ Executes arbitrary JavaScript in the Obsidian app context. Has access to the ful
 ### Console & Errors
 
 ```bash
-obsidian dev:console limit=20          # Recent console output
-obsidian dev:errors                    # Recent error messages
+obsidian dev:debug on              # Start capturing console output (required before dev:console)
+obsidian dev:debug off             # Stop capturing console output
+obsidian dev:console limit=20     # Recent console output (requires dev:debug on first)
+obsidian dev:errors                # Recent error messages
 ```
 
+> **Note:** `dev:console` will return an error unless `dev:debug on` has been run first in the current session.
+
 ---
 
 ## Vault & System
@@ -369,9 +378,11 @@ obsidian tag name="urgent" | while read -r note; do
 done
 
 # Export search results as JSON and process with jq
-obsidian search query="meeting" format=json | jq '.[].path'
+# format=json returns an array of file path strings: ["folder/note.md", ...]
+obsidian search query="meeting" format=json | jq '.[]'
 
-# Filter console errors
+# Filter console errors (requires dev:debug on first)
+obsidian dev:debug on
 obsidian dev:console limit=50 | grep -i error
 ```