obsidian-curatorManage Obsidian vaults via LiveSync CouchDB — capture notes, AI-enrich and file them, manage tasks, audit and tidy vault structure. Use when working with Obs...
Install via ClawdBot CLI:
clawdbot install philmossman/obsidian-curatorManage 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.
preinstall, install, or postinstall scripts — npm install only copies filesnano (CouchDB client) and date-fns (date parsing)~/.obsidian-curator/config.json — never transmitted except to your own CouchDBRun the interactive wizard — it tests the CouchDB connection live:
obsidian-curator initConfigures: CouchDB connection, vault structure preset (PARA/Zettelkasten/Johnny Decimal/Flat/Custom), AI provider (OpenAI/Anthropic/Ollama/None), task projects.
Config location: ~/.obsidian-curator/config.json
obsidian-curator capture "Quick thought about project X"
obsidian-curator capture "Meeting notes from standup" --source meetingEnrich inbox notes with tags, summary, and suggested folder:
obsidian-curator process
obsidian-curator process --limit 5 --dry-run
obsidian-curator process --force # re-process already-processed notesRoute processed notes to canonical vault folders:
obsidian-curator file
obsidian-curator file --dry-run --min-confidence 0.8Check vault structure against configured canonical folders:
obsidian-curator auditFind duplicates, structure violations, dead notes. With AI, ambiguous cases are triaged automatically:
obsidian-curator tidy --dry-run
obsidian-curator tidy --checks dupes,stubsobsidian-curator tasks # list open tasks
obsidian-curator tasks --project Work --priority high
obsidian-curator task "call dentist next Tuesday" # create task (parses dates, priority, project)
obsidian-curator done "dentist" # mark done by partial title matchobsidian-curator config show
obsidian-curator config set ai.provider ollama
obsidian-curator config set vault.host 192.168.1.100const { VaultClient, Curator, createAIAdapter, loadConfig } = require('obsidian-curator');
const config = loadConfig();
const vault = new VaultClient(config.vault);
await vault.ping();
const ai = createAIAdapter(config);
const curator = new Curator({ vault, ai, config });
await curator.capture('Quick thought');
await curator.process({ limit: 5 });
await curator.file({ dryRun: true });
await curator.audit();
await curator.tidy({ checks: ['dupes', 'stubs'], dryRun: true });
const tasks = await curator.tasks({ status: 'open', project: 'Work' });
await curator.createTask('call Alice next Friday');
await curator.taskBrief(); // markdown summary| Provider | Cost | Privacy | Setup |
|----------|------|---------|-------|
| none | Free | Local | Default — rule-based features only |
| ollama | Free | Local | config set ai.provider ollama + model name |
| openai | Pay-per-use | Cloud | config set ai.provider openai + API key |
| anthropic | Pay-per-use | Cloud | config set ai.provider anthropic + API key |
| Custom/OpenRouter | Varies | Varies | Use openai provider with custom baseUrl |
Generated Mar 1, 2026
Researchers can use obsidian-curator to capture fleeting notes from experiments or literature, automatically enrich them with AI-generated summaries and tags, and file them into a structured Zettelkasten vault via CouchDB. This streamlines organizing insights without manual effort, enabling efficient retrieval and synthesis across projects.
Development teams can employ obsidian-curator to manage Obsidian vaults for project documentation, using the capture command for quick meeting notes and the tasks feature to track action items. AI processing helps categorize notes into PARA folders, while audit ensures consistency across team members sharing a CouchDB backend.
Writers can leverage obsidian-curator to gather ideas via capture, use AI to process and tag notes for articles or books, and file them into custom vault structures. The tidy feature helps identify duplicates or dead notes, maintaining a clean repository for creative projects without local file management.
Consultants can utilize obsidian-curator to capture client interactions and project details, with AI enriching notes for better categorization. The audit and tidy commands ensure vault integrity, while tasks manage follow-ups, all synchronized via CouchDB for secure, team-wide access without external dependencies.
Offer a cloud-hosted version with basic capture and task features for free, while charging for advanced AI processing, custom vault presets, and team collaboration tools. Revenue comes from monthly subscriptions, targeting individuals and small teams who value automated note management without setup overhead.
Sell licenses for on-premise deployment in organizations, providing enhanced security, support, and integration with existing CouchDB infrastructure. Revenue is generated through one-time licenses or annual support contracts, appealing to industries like finance or healthcare with strict data privacy requirements.
Create a marketplace where users can purchase or subscribe to specialized AI models, custom vault presets, or plugins that extend obsidian-curator's functionality. Revenue comes from transaction fees or developer commissions, catering to power users seeking tailored solutions for specific use cases.
💬 Integration Tip
Ensure CouchDB is properly configured with LiveSync and E2EE disabled; use the init wizard for seamless setup and test connectivity before relying on AI features.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Create, search, and manage Bear notes via grizzly CLI.
Track water and sleep with JSON file storage
Notion API for creating and managing pages, databases, and blocks.
Smart ClawdBot documentation access with local search index, cached snippets, and on-demand fetch. Token-efficient and freshness-aware.
Work with Obsidian vaults as a knowledge base. Features: fuzzy/phonetic search across all notes, auto-folder detection for new notes, create/read/edit notes with frontmatter, manage tags and wikilinks. Use when: querying knowledge base, saving notes/documents, editing existing notes by user instructions.