Skip to main content

v1.2.0 — AI Agent / Automation Support

· 2 min read

v1.2.0 makes Obsidiosaurus triggerable by AI agents and external automation — the build can now be started over a REST API without any user interaction.

What's new​

Headless Conversion via Local REST API​

Two Obsidian commands are now exposed that can be called via the Local REST API plugin:

Command IDBehavior
obsidiosaurus:runRuns the conversion without the confirmation modal — intended for unattended/agent use.
obsidiosaurus:run-with-confirmShows the preview modal and waits for a user click — same as the ribbon icon.

Status File for Polling​

After every run (or attempt) the plugin writes a status file to .obsidiosaurus/last-run.json inside the vault. Agents can poll this file to check completion and pick up errors.

{
  "status": "running" | "success" | "error",
  "startedAt": "2026-05-16T11:52:20.051Z",
  "finishedAt": "2026-05-16T11:52:20.064Z",
  "filesToProcess": 1,
  "filesToDelete": 1,
  "error": { "message": "...", "stack": "..." },
  "version": "1.2.0"
}

Counts (filesToProcess, filesToDelete) reflect the change-preview snapshot taken before the run, not necessarily the exact number of files written.

Example Agent Workflow​

API_KEY="<your local-rest-api key>"

# 1. Trigger the build (returns immediately)
curl -sk -X POST -H "Authorization: Bearer $API_KEY" \
  https://localhost:27124/commands/obsidiosaurus:run/

# 2. Poll status until done
curl -sk -H "Authorization: Bearer $API_KEY" \
  https://localhost:27124/vault/.obsidiosaurus/last-run.json