obsidian-curator

Manage Obsidian vaults through the CouchDB database that powers Obsidian LiveSync. Capture, process, file, audit, tidy, and manage tasks — all via CLI or Node.js API.

Prerequisites: CouchDB with LiveSync configured, E2EE disabled.

Security & Trust

• Open source: github.com/philmossman/obsidian-curator (MIT)
• npm provenance: Published via GitHub Actions OIDC with Sigstore attestation — cryptographically verifiable build provenance
• No lifecycle scripts: No preinstall, install, or postinstall scripts — npm install only copies files
• Minimal dependencies: Only nano (CouchDB client) and date-fns (date parsing)
• Local network only: Connects to your CouchDB instance (user-configured host/port). No external telemetry, no phone-home, no data leaves your network
• Credentials: Stored locally in ~/.obsidian-curator/config.json — never transmitted except to your own CouchDB
• E2EE note: LiveSync E2EE must be disabled because the tool reads/writes vault documents directly via CouchDB. This is a LiveSync architectural requirement, not a security compromise by this tool

Setup

Run the interactive wizard — it tests the CouchDB connection live: