From ba2c096323c3ed3c1dddebd28430ef0aef42c089 Mon Sep 17 00:00:00 2001 From: Misaka_Company Date: Wed, 27 May 2026 18:13:32 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs(obsidian-cli):=20Add=20trou?= =?UTF-8?q?bleshooting=20guide=20for=20CLI=20connection=20issues?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 --- skills/obsidian-cli/SKILL.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/skills/obsidian-cli/SKILL.md b/skills/obsidian-cli/SKILL.md index 2c806fc..4338d6d 100644 --- a/skills/obsidian-cli/SKILL.md +++ b/skills/obsidian-cli/SKILL.md @@ -191,6 +191,19 @@ obsidian restart # Restart app --- +## Troubleshooting: CLI Connection Issues + +When `obsidian` commands return empty output (with exit code 0) or are unresponsive, the CLI bridge connection is likely broken. Follow this procedure: + +1. **Detect the issue**: If a command produces empty output with exit code 0, the bridge connection is broken +2. **Ask the user**: Use AskUserQuestion to ask the user whether they allow running `obsidian reload` to reload the Obsidian window and restore the connection +3. **If the user agrees**: Run `obsidian reload`, wait about 3 seconds, then retry the original command +4. **If the user declines**: Fall back to reading/writing vault files directly via the filesystem (locate the vault path from `%APPDATA%/obsidian/obsidian.json`, then use Read/Edit/Write tools to operate on .md files directly) + +> **Note**: `obsidian reload` reloads the Obsidian window. It does not affect unsaved data, but will briefly interrupt the current editing state. + +--- + ## Tips - **Clipboard:** Add `--copy` to any command to copy output.