{
  "schemaVersion": 1,
  "methodology": "https://ionbin.com/interfaces/methodology/#evaluations",
  "evaluation": {
    "id": "obsidian-cli",
    "testedOn": "2026-10-21",
    "coverage": "unavailable",
    "summary": "Not run: the Obsidian CLI controls a running Obsidian desktop app with a vault, and the review environment had neither, so no command was executed.",
    "identity": {
      "version": "Not observed (documentation requires the 1.12.7+ installer)",
      "target": "obsidian command registered by the Obsidian desktop app (not installed)",
      "integrity": "Not available: no binary or endpoint was obtained or contacted for this record."
    },
    "environment": [
      "Headless review environment without the Obsidian desktop app, a vault or an Obsidian account; nothing was installed or contacted.",
      "Recorded October 21, 2026."
    ],
    "checks": [
      {
        "id": "obsidian-cli-help",
        "name": "Credential-free help output",
        "method": "obsidian help in a terminal after enabling Command line interface in Settings → General.",
        "expected": "The CLI lists its commands; the first command launches Obsidian if it is not running.",
        "observed": "Not run: the CLI is shipped inside the desktop app installer and needs the app running, and IonBin had no desktop session with Obsidian installed for this review.",
        "outcome": "blocked"
      }
    ],
    "findings": [
      {
        "title": "Commands act on the active vault by default",
        "basis": "documented",
        "severity": "informational",
        "detail": "Without vault=, the CLI uses the vault in the current folder or the active vault, and many commands default to the active file.",
        "practicalAdvice": "Pass vault= and path= explicitly in scripts so an agent cannot edit the wrong note."
      },
      {
        "title": "Write and developer commands are powerful",
        "basis": "documented",
        "severity": "medium",
        "detail": "The CLI can overwrite or delete files, install community plugins and run JavaScript in the app with eval.",
        "practicalAdvice": "Give agents read and search commands by default; require approval before create overwrite, delete, plugin:install or eval."
      }
    ],
    "caveats": [
      "Behavior is as documented by Obsidian; none was observed.",
      "Obsidian Headless is a separate client for Sync and Publish that runs without the desktop app; it was not evaluated here."
    ],
    "notTested": [
      "Any CLI command, including help, search, read, create and delete, because the desktop app was not installed or running.",
      "Vault targeting, plugin installation, eval, Sync and Publish commands, and behavior on Windows, macOS and Linux registration paths."
    ],
    "sources": [
      {
        "label": "Official Obsidian CLI documentation",
        "url": "https://obsidian.md/help/cli"
      }
    ],
    "reportUrl": "/interface-evaluations/obsidian-cli.json"
  }
}
