AgriciDaniel /claude-obsidian
Self-organizing AI second brain for Obsidian + Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathy's LLM Wiki pattern.
★ 16,508⑂ 1,621👁 62⑃ 123● 88▤ 13
+16
Daily
16,508
stars
1,621
forks
62
watchers
123
prs
88
issues
13
releases
README
claude-obsidian
Your AI second brain for Obsidian, built for Claude Code.
Drop in sources. Get a connected wiki that grows every time you use it.
Install ·
See the vault ·
Skills ·
Agents ·
Safety ·
Modes ·
FAQ
claude-obsidian turns the things you read into a knowledge base that keeps getting more useful. Drop a paper, an article, a transcript or your own notes into the vault, and Claude reads them, writes linked notes with sources, and files everything into one connected knowledge graph you can explore in Obsidian.
- Capture. Put sources in inbox/. The originals are kept, untouched, so every summary can point back to where it came from.
- Connect. Claude writes linked pages, indexes and maps of content, so new ideas join the graph instead of piling up.
- Ask. Get answers from what your vault already knows, with citations, without changing a single file.
- Save. Keep the answers worth keeping as notes, one at a time, when you ask.
- Check. A health check finds dead links, orphan pages and gaps before they spread.
Everything stays as plain Markdown files on your computer. No cloud database, no lock-in, no telemetry. Apart from the AI tool you chat with, nothing leaves your machine unless you say so.
See the vault
The result is a normal Obsidian vault that stays useful with or without an AI: browse it in Graph view, or lay it out as a map in Obsidian Canvas.
Linked notes in Graph view · A knowledge map in Obsidian Canvas
Install
You need Claude Code, Python 3.11 or newer and, for the visual side, Obsidian. Install the plugin with two commands:
bash
claude plugin marketplace add AgriciDaniel/claude-obsidian
claude plugin install claude-obsidian@agricidaniel-claude-obsidian
Then open the folder you want as your vault and start Claude Code there:
bash
claude start Claude Code in your vault folder
/claude-obsidian:wiki set up the vault (shows you a preview first)
/claude-obsidian:wiki-ingest turn what is in inbox/ into linked notes
/claude-obsidian:wiki-query ask a question, answered from your notes
/claude-obsidian:save keep a good answer as a note
/claude-obsidian:wiki-lint health check: dead links, orphans, gaps
Open the same folder in Obsidian with Open folder as vault to browse your notes as they grow.
Already have an Obsidian vault? /claude-obsidian:wiki can adopt it without moving your notes. The installation guide walks through it.
Other AI tools: Codex, OpenCode, Gemini, ZCode, Cursor and Windsurf
claude-obsidian is a set of Agent Skills, so it also runs in other hosts. From a copy of this repo, preview the setup, then apply it:
bash
git clone https://github.com/AgriciDaniel/claude-obsidian.git
cd claude-obsidian
bash scripts/setup-multi-agent.sh --host codex preview, writes nothing
bash scripts/setup-muTop issues
#165[bug] marketplace add AgriciDaniel/claude-obsidian doesnt work2 comments · 2026-08-13#216[feature] Opt-in Firecrawl runner for the url capture adapter0 comments · 2026-11-04#156[feature] Retrieval-quality eval harness (recall@k + MRR) so retrieval changes can produce the evidence CONTRIBUTING requires1 comments · 2026-08-02#104Roadmap: Expand support to non-cloud harnesses (OpenCode, OMP, OmiAI, etc.)?1 comments · 2026-06-27#6how large the wiki is acceptable?1 comments · 2026-04-14#217Scaling issues under automated capture: lock PID check not namespace-aware, no way to prune transactions, per-page chunk scan cost0 comments · 2026-11-12#2123.0.1 fails to import on Python 3.9 (limits.py line 11, int | str annotation)0 comments · 2026-10-26#197Permission request: introducing the wiki-query skill on PrompTown (free, not an endorsement)0 comments · 2026-10-13
Latest release
Claude Obsidian v3.0.1 - Original Plugin Name Restored v3.0.1 2026-10-21Claude Obsidian v3.0.1 restores the Claude plugin name claude-obsidian, so commands are /claude-obsidian: again. Version 3.0.0 had renamed the plugin to agricidaniel-obsidian, which changed every command. Nothing else changes: all of the 3.0.0 hardening is included. Upgrading From 2.x, this is an ordinary update and your commands never change: bash claude plugin marketplace update agricidaniel-claude-obsidian claude plugin update claude-obsidian@agricidaniel-claude-obsidian From 3.0.0 (agricidaniel-obsidian), the marketplace update moves your settings back, then install once: bash claud