claude-obsidian
Local-first AI second brain for Obsidian and Claude Code.
Build a connected knowledge base using plain Markdown and Claude Code.
claude-obsidian is a local-first knowledge system that turns source materials into linked Obsidian pages using Claude Code. It suits knowledge workers, researchers, and developers who want an agent-driven second brain without sacrificing file ownership.
What it is
It provides 15 integrated agent skills that handle source ingestion, grounded Q&A, and vault maintenance directly inside an Obsidian directory. The system uses a transaction-safe model where parallel worker drafts are inspected and applied through a single recoverable bundle.
Who it's for
It suits technical professionals and researchers who already use Obsidian and Claude Code for heavy note management. It does not suit users looking for an automatic cloud-synced note recorder with zero configuration.
Key features
Content-Addressed Capture
Preserves immutable local source copies before starting synthesis.
Provenance Ledgers
Tracks authority, freshness, support, and contradiction for claims.
Transaction-Safe Apply
Applies changes as single recoverable transactions to prevent race conditions.
Deterministic BM25
Falls back to reliable local retrieval when embedding models are untrusted.
Multi-Agent Support
Extends beyond Claude Code to Codex, OpenCode, Gemini, and ZCode.
Up and running in 3 steps
Our honest verdict
What's great
- Your knowledge vault remains plain Markdown files under your direct ownership
- Source evidence survives summaries to keep unsupported claims visible
- Includes 15 specialized skills for query, linting, research, and canvas views
- Requires explicit approval plans before executing mutating vault commands
Where it falls short
- Requires manual command-line execution and setup of Claude Code or compatible hosts
- PDF, EPUB, URL, and OCR inputs require configured external runners
- Not a turnkey consumer app; demands familiarity with local file navigation
Pricing & license
Free under its open source license. The only cost is running it yourself using your own hardware and AI API credits.
Open remote AI-training roles
880 open remote AI-training roles, updated November 15, 2026; most pay $20–$175 an hour. Zekai lists them free; the application goes to the employer’s platform.
Alternatives
These reviewed AI tools do the same job instantly — from our scored directory.
Use it, or have us set it up
FAQ
Where are my actual notes stored?
Notes are stored as plain Markdown files in a separate user-owned Obsidian vault directory of your choosing.
Can I use hosts other than Claude Code?
Yes, setup scripts support portable skill links for hosts like Codex, OpenCode, Gemini, and ZCode.
