Skip to content

Configuration

The setup script (setup.sh) auto-detects your Obsidian binary and vault, writing config to ~/.config/obsidian-cli/config.yaml.

Location: ~/.config/obsidian-cli/config.yaml

vault: "MyVault"
vault_path: "~/Documents/MyVault/"
binary: "/Applications/Obsidian.app/Contents/MacOS/obsidian"
KeyDescription
vaultObsidian vault name (as shown in vault switcher)
vault_pathAbsolute path to the vault directory (trailing slash)
binaryPath to the Obsidian binary
/Applications/Obsidian.app/Contents/MacOS/Obsidian
~/Applications/Obsidian.app/Contents/MacOS/Obsidian
/usr/bin/obsidian
/usr/local/bin/obsidian
/snap/bin/obsidian
/var/lib/flatpak/exports/bin/md.obsidian.Obsidian
~/.local/bin/obsidian

The setup script reads Obsidian’s vault registry to find your vaults:

  • macOS: ~/Library/Application Support/obsidian/obsidian.json
  • Linux: ~/.config/obsidian/obsidian.json

If you have multiple vaults, the script prompts you to choose one.

To change your vault or binary, re-run the setup script:

Terminal window
~/obsidian-cli-agent/setup.sh

It will ask before overwriting an existing config.