claude-obsidian

claude-obsidian turns an Obsidian vault into something a coding agent can actually work in. Drop a source in and the agent reads it, pulls out entities and concepts, writes cross-referenced pages, and keeps the links honest. Your vault stays a plain directory of Markdown files rather than a proprietary database, which is what matters if you expect to still have these notes in five years. MIT licensed.

Now at v2.1.0 with 15 skills spanning ingestion, querying, wiki building, linting, research, and Canvas generation. Operations are transactional with rollback and conflict detection, which sounds dull until an agent half-finishes a bulk edit across 200 notes. Needs Python 3.11 or newer plus bash. Obsidian itself is optional, since the output is just Markdown.

It no longer assumes Claude Code. Cursor, Windsurf, Codex, OpenCode, and Gemini all work, and you choose a methodology up front: generic, LYT, PARA, or Zettelkasten. Solo note-takers and researchers get the most out of it. Small teams can share a vault through git. Medium and large teams should not expect a multi-user story, because there is not one.

The catch is the agent bill. Every ingest and wiki-build pass burns a lot of tokens against whatever agent you point at it, and re-linting a large vault is not cheap. The sharper catch: an agent that writes your notes writes its mistakes into them confidently. Source traceability tells you where a sentence came from, not whether it is true.