wiki-cli

1# Obsidian CLI read transport
2 
3Use this skill only to detect transport and read or search a selected vault.
4The official executable is `obsidian`; binary presence alone does not prove it
5is usable.
6 
7Resolve the installed product root from this skill's own location, not from the
8vault or current working directory:
9 
10```bash
11PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian
12DETECT_TRANSPORT="$PRODUCT_ROOT/scripts/detect-transport.sh"
13test -f "$DETECT_TRANSPORT"
14```
15 
16Every `../wiki/references/` link in this file resolves the same way, relative
17to this skill's own directory under `$PRODUCT_ROOT`, never relative to the
18selected vault's `wiki/` directory.
19 
20## Detect safely
21 
22Probe without persisting host state:
23 
24```bash
25bash "$DETECT_TRANSPORT" --peek --vault "$VAULT"
26```
27 
28Trust `available.cli.usable`, not merely `present` or exit status. A supported
29CLI can still be unavailable because the Obsidian app is not running, command
30line access is disabled, or its response is an error. Use filesystem reads as
31the portable fallback.
32 
33Persist a refreshed `.vault-meta/transport.json` only when the user or setup
34workflow asks for a transport snapshot:
35 
36```bash
37bash "$DETECT_TRANSPORT" --force --vault "$VAULT"
38```
39 
40That file is derived runtime configuration, not knowledge content. Preserve a
41valid `manual_override` recorded by the detector.
42 
43## Read and search
44 
45Run official CLI commands from the selected vault so Obsidian resolves the
46…