Repolode
Submit
AgriciDaniel

AgriciDaniel/claude-obsidian

An AI second brain for Obsidian that Claude Code reads, links and files into a connected Markdown knowledge graph you own.

Open-source alternative to:Notion

View on GitHubWebsite
Stars
16,240
Forks
1,598
Open issues
22
Last commit
13 days ago

What is it?

claude-obsidian is a Claude Code plugin that builds and maintains a personal wiki inside an Obsidian vault. You place papers, articles, transcripts or notes in an inbox folder, and Claude writes linked pages with source references, then files them into indexes and maps of content. Originals are kept unchanged so every summary can be traced back to its source.

All content is stored as plain Markdown on your own machine, with no cloud database. Users can ask questions answered from the vault with citations, save useful answers as new notes, and run a health check that reports dead links, orphan pages and empty sections. Changes are planned first and applied as a single transaction, and the write stops with a conflict if you edit a note during planning.

The project ships 15 Agent Skills and 3 read-only agents. Besides Claude Code, the skills can be linked into Codex, OpenCode, Gemini, ZCode, Cursor and Windsurf using a setup script. The vault can be organized in Generic, LYT, PARA or Zettelkasten layouts.

Key features

  • 01Turns dropped sources into linked Markdown pages with source references.
  • 02Keeps original source files untouched and content-addressed.
  • 03Answers questions from the vault with citations, without modifying files.
  • 04Runs a health check for dead links, orphan pages and gaps.
  • 05Applies changes as a single transaction with conflict detection and recovery.
  • 06Works with Claude Code and other Agent Skills hosts such as Codex and Cursor.

Use cases

  • Researchers who want every note in a literature review traced back to its source.
  • Writers linking ideas from videos, articles and books in one graph.
  • Teams keeping project knowledge in Markdown and searching it with an AI assistant.

Quick start

  1. 1

    Add the plugin marketplace in Claude Code

    claude plugin marketplace add AgriciDaniel/claude-obsidian
  2. 2

    Install the claude-obsidian plugin

    claude plugin install claude-obsidian@agricidaniel-claude-obsidian
  3. 3

    Open your vault folder and set up the wiki with /claude-obsidian:wiki (preview shown before creating)

  4. 4

    Add sources to inbox/ and run /claude-obsidian:wiki-ingest to turn them into linked notes

    /claude-obsidian:wiki-ingest

Things to know

  • Requires Claude Code, Python 3.11 or newer, and Obsidian for the visual side.
  • On Windows, writing to the vault requires WSL; native Windows can only inspect and preview.

In collections

Claude Code tools, skills & pluginsAI agent skill librariesStatic site generators & documentation tools

Topics

#obsidian#claude-code#knowledge-management#note-taking#markdown#knowledge-graph#agent-skills#ai-note-taking#ai-second-brain#claude-code-skill

FAQ

What is claude-obsidian?
An AI second brain for Obsidian that Claude Code reads, links and files into a connected Markdown knowledge graph you own. claude-obsidian is a Claude Code plugin that builds and maintains a personal wiki inside an Obsidian vault. You place papers, articles, transcripts or notes in an inbox folder, and Claude writes linked pages with source references, then files them into indexes and maps of content. Originals are kept unchanged so every summary can be traced back to its source.
Is claude-obsidian free to use? What license does it have?
claude-obsidian is open source under the MIT license. Check the license terms before using it in commercial products.
Is claude-obsidian still maintained?
Actively maintained. The last commit to claude-obsidian was on Oct 25, 2026.
What can I use claude-obsidian for?
Researchers who want every note in a literature review traced back to its source. Writers linking ideas from videos, articles and books in one graph. Teams keeping project knowledge in Markdown and searching it with an AI assistant.
How do I install claude-obsidian?
Add the plugin marketplace in Claude Code: claude plugin marketplace add AgriciDaniel/claude-obsidian Install the claude-obsidian plugin: claude plugin install claude-obsidian@agricidaniel-claude-obsidian Open your vault folder and set up the wiki with /claude-obsidian:wiki (preview shown before creating) Add sources to inbox/ and run /claude-obsidian:wiki-ingest to turn them into linked notes: /claude-obsidian:wiki-ingest
Where can I get claude-obsidian?
The source code and installation instructions are on GitHub: https://github.com/AgriciDaniel/claude-obsidian

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects