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
PythonMITCreated 2026-04-07
下载:Claude Obsidian v3.0.1 - Original Plugin Name RestoredClaude-3.0.1 ↓3.0.12026-10-21
+16
日增长
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-mu

Top issues

Latest release

Claude Obsidian v3.0.1 - Original Plugin Name Restored v3.0.1 2026-10-21
Claude 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON