Skip to main content
ClaudeWave
EN, English
AgriciDaniel / Plugins

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.

  • 15.7k stars
  • 1.6k forks
  • 21 open issues
  • Language: Python
  • License: MIT
  • updated

Install

Claude Code
/plugin marketplace add AgriciDaniel/claude-obsidian
/plugin install claude-obsidian
  1. Inside Claude Code, add the marketplace and install the plugin with the commands above.
  2. Follow any post-install configuration from the README.
  3. Restart the session if commands or hooks do not show up immediately.

Editor's note

Claude-obsidian is a Claude Code plugin that turns an Obsidian vault into a self-organizing knowledge base by giving Claude Code 15 structured skills covering ingestion, retrieval, maintenance, and reasoning. When a user drops in a source, Claude reads it, extracts entities and concepts, writes plain Markdown notes, and wires them into the vault with bidirectional links. Four primary slash commands drive daily use: `/wiki` scaffolds and continues the vault, `/autoresearch` runs an autonomous multi-step research loop, `/canvas` generates visual Obsidian canvas maps, and `/think` applies a 10-principle reasoning framework introduced in v1.9. Retrieval uses a hybrid stack combining contextual prefix search, BM25, and cosine reranking based on Anthropic's September 2024 contextual retrieval research. Version 1.8 added first-class support for LYT, PARA, Zettelkasten, and Generic methodology modes, and v1.7 introduced per-file advisory locking to prevent multi-writer corruption. Optional MCP integration and a DragonScale Memory extension are also available. The project targets researchers, writers, and developers who want a private, locally owned alternative to cloud note tools.

Installable items

16 items in this repository

Run a bounded, source-grounded research loop, draft a cited dossier, and optionally propose a separately reviewed canonical vault merge. Use when the user wants autonomous or deep research that may access the public web. Triggers: /autoresearch, autoresearch, research this topic, deep dive into, investigate, find everything about, research and file, go research, build a wiki on.

Install
canvasSkill

Create, inspect, and update Obsidian JSON Canvas boards with text, file, link, group, and edge nodes. Use for canvas status, canvas lists, visual maps, zones, spatial layouts, adding vault notes or media to a .canvas file, and requests such as create canvas, add to canvas, or put this on the canvas.

Install

Plan and, with explicit network consent, use an optional external Defuddle cleaner to extract article-like HTTPS pages as Markdown. Use for defuddle, clean this URL, strip page clutter, readable Markdown from a web page, or preparing a web source for later wiki ingestion.

Install

Explain, draft, and validate Obsidian Bases .base files with filters, formulas, properties, summaries, and table, card, or list views. Use for Obsidian Bases, database-like vault views, dynamic tables, reading lists, task trackers, filters, formulas, summaries, and .base file edits.

Install

Explain, draft, or validate Obsidian Flavored Markdown syntax: properties, wikilinks, embeds, callouts, tags, comments, highlights, block references, math, and Mermaid. Use when the user explicitly requests Obsidian note formatting or syntax help, not for general Markdown or broad vault operations.

Install
saveSkill

Save a user-selected answer, decision, insight, or session summary into an Obsidian vault as one reviewed transaction. Use only when the user explicitly asks to preserve specific conversation content, not when they supply a file or URL to ingest. Triggers: /save, save this, save that answer, file this conversation, save this analysis, keep this insight, preserve this chat result.

Install
thinkSkill

Apply the Fable-derived 10-stage OBSERVE, OBSERVE, LISTEN, THINK, CONNECT, CONNECT, FEEL, ACCEPT, CREATE, GROW loop to consequential or ambiguous reasoning and decisions. Use for think this through, deep think, architecture review, postmortem, tradeoff analysis, or challenges to assumptions. This is a reasoning review, not a deterministic vault health check or repair workflow.

Install
verifierSubagent

>

Install
wikiSkill

Initialize, adopt, and route work for a separate Obsidian knowledge vault through the portable claude-obsidian core. Use for vault setup, scaffolding, workspace selection, cross-project configuration, or choosing the correct wiki sub-skill. Triggers: /wiki, set up wiki, scaffold vault, create knowledge base, adopt this vault, Obsidian vault, second brain setup, persistent wiki.

Install

Detect and use the official Obsidian command-line interface for read-only vault access; use for wiki-cli, Obsidian CLI, Obsidian read, Obsidian search, vault transport, which transport, transport detection, backlinks, tags, or Obsidian command line. Mutations always go through the claude-obsidian transaction core.

Install

Create a bounded, extractive, structurally idempotent rollup of recent Obsidian wiki log entries, with dry-run preview by default and one optional transaction apply. Use for manual log compression without modifying child pages. Triggers: fold the log, run a fold, run wiki-fold, log rollup, roll up log entries, commit the fold.

Install

Ingest supplied source material into an Obsidian vault with provenance and claim tracking: pasted text, files staged in the selected vault's inbox or .raw archive, or explicitly approved URLs. Use for a single source or bounded batch, not for saving an assistant answer. Triggers: ingest, ingest this file, ingest this URL, process this source, read and file this source, batch ingest, ingest these sources.

Install

Run a deterministic, read-only health check on an Obsidian wiki. Use for lint, vault health check, audit wiki health, find orphans, find dead links, frontmatter audit, provenance audit, or wiki audit. Reports graph, link, frontmatter, provenance-ledger, empty-section, and stale-index findings; it does not reason broadly or repair files.

Install

Read or configure the vault filing methodology and suggest destinations for planned knowledge creation under Generic, LYT, PARA, or Zettelkasten. Use for wiki mode, methodology mode, what is my vault mode, set vault mode, switch to PARA, use LYT, Zettelkasten setup, change mode, configure mode, or methodology routing. This skill does not save content or migrate notes.

Install

Answer an explicitly vault-scoped question from an Obsidian wiki without changing it. Use when the user selects the vault as the evidence source: query the wiki, query quick, query deep, explain from the wiki, summarize the vault, find in wiki, search the wiki, or based on the wiki. Do not route ordinary general-knowledge questions here.

Install

Build and query a vault-local contextual BM25 retrieval index with optional multilingual Nomic cosine reranking; use for retrieve, hybrid retrieval, BM25, rerank, contextual retrieval, chunk search, vault search, semantic search, find relevant passages, or retrieval diagnostics. Derived caches stay under .vault-meta, remote egress requires explicit consent, and unavailable reranking falls back deterministically.

Install
README

Plugins overview

Full README on GitHub

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:

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:

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:

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-multi-agent.sh --host codex --apply    # link the skills

Use --host opencode, --host gemini or --host zcode the same way. Cursor and Windsurf need a workspace: --host cursor --host windsurf --workspace --apply. Every host is covered in the installation guide.

Windows

On Windows, use WSL for anything that writes to the vault. Native Windows can inspect and preview, and stops with a clear error instead of writing. The Windows and WSL guide has the details.

Upgrading from 2.x or 3.0.0

claude plugin marketplace update agricidaniel-claude-obsidian
claude plugin update claude-obsidian@agricidaniel-claude-obsidian

Version 3.0.0 alone used the plugin name agricidaniel-obsidian. If you installed that one, run the marketplace update, then claude plugin install claude-obsidian@agricidaniel-claude-obsidian, and restart Claude Code. See the namespace migration.

15 skills, one system

Talk to it in plain words, or call any skill by name with /claude-obsidian:. Open a group to see what is inside.

Build and use the wiki (5)

SkillWhat it does
wikiSets up a new vault or adopts yours, checks it is ready and routes your request
wiki-ingestTurns captured sources into linked pages with their sources recorded
wiki-queryAnswers from what is already in the vault, read-only
saveKeeps one answer or insight as a note, only when you ask
wiki-lintFinds dead links, orphan pages, missing metadata and empty sections

Extend the workflow (7)

SkillWhat it does
autoresearchBounded web research, only with your consent, merged after review
canvasCreates and updates Obsidian Canvas boards
defuddlePlans a clean Markdown capture of a web page; the cleaner itself is an optional external tool
wiki-foldRolls up the operation log into short, traceable summaries
wiki-modeSets how new notes are filed: Generic, LYT, PARA or Zettelkasten
wiki-retrieveLocal BM25 search with optional reranking
wiki-cliReads and searches through the official Obsidian command line

Reference (3)

SkillWhat it does
obsidian-markdownCorrect Obsidian Markdown: links, embeds, callouts and properties
obsidian-basesNative .base tables, cards, filters and formulas
thinkA structured review loop for hard decisions

Meet the crew

Topics
agent-skillsai-note-takingai-second-brainclaude-codeclaude-code-skillclaude-memoryclaude-pluginkarpathy-llm-wikiknowledge-graphknowledge-managementnote-takingnotion-alternativeobsidianobsidian-aiobsidian-pluginobsidian-second-brainopen-sourcepersonal-knowledge-managementpkmsecond-brain
Frequently asked

What people ask about claude-obsidian

What is AgriciDaniel/claude-obsidian?

AgriciDaniel/claude-obsidian is plugins for the Claude AI ecosystem. 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. It has 15.7k GitHub stars and its last recorded update is dated 2026-10-22.

How do I install claude-obsidian?

You can install claude-obsidian by cloning the repository (https://github.com/AgriciDaniel/claude-obsidian) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.

Is AgriciDaniel/claude-obsidian safe to use?

Our security agent has analyzed AgriciDaniel/claude-obsidian and assigned a Trust Score of 100/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.

Who maintains AgriciDaniel/claude-obsidian?

AgriciDaniel/claude-obsidian is maintained by AgriciDaniel. The last recorded GitHub activity is dated 2026-10-22, with 21 open issues.

Are there alternatives to claude-obsidian?

Yes. On ClaudeWave you can browse similar plugins at /categories/plugins, sorted by popularity or recent activity.

Maintain this repo? Show its Trust Score in your README

The badge shows this repository's current Trust Score and verdict, and links back to this page. It follows the catalogue data: nobody can buy or edit the score it displays.

ClaudeWave Trust Score for AgriciDaniel/claude-obsidian
Markdown (README)
[![ClaudeWave Trust Score for AgriciDaniel/claude-obsidian](https://claudewave.com/api/badge/agricidaniel-claude-obsidian)](https://claudewave.com/en/repo/agricidaniel-claude-obsidian)
HTML
<a href="https://claudewave.com/en/repo/agricidaniel-claude-obsidian"><img src="https://claudewave.com/api/badge/agricidaniel-claude-obsidian" alt="ClaudeWave Trust Score for AgriciDaniel/claude-obsidian" width="320" height="64"></a>

What the badge means and how the score is computed