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.
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.
- ✓Open-source license (MIT)
- ✓Actively maintained (<30d)
- ✓Healthy fork ratio
- ✓Clear description
- ✓Topics declared
- ✓Documented (README)
- !README contains suspicious pattern: eval\s*\(
/plugin marketplace add AgriciDaniel/claude-obsidian
/plugin install claude-obsidian16 items in this repository
Ingest sources into the Obsidian wiki vault. Reads a source, extracts entities and concepts, creates or updates wiki pages, cross-references, and logs the operation. Supports files, URLs, and batch mode. Triggers on: ingest, process this source, add this to the wiki, read and file this, batch ingest, ingest all of these, ingest this url.
Visual layer of the wiki. Add images, text cards, PDFs, and wiki pages to Obsidian canvas files with auto-positioning inside zones. Integrates with /banana for image capture. Triggers on: /canvas, canvas new, canvas add image, canvas add text, canvas add pdf, canvas add note, canvas zone, canvas list, canvas from banana, add to canvas, put this on the canvas, open canvas, create canvas.
Strip clutter from web pages before ingesting into the wiki. Removes ads, navigation, headers, footers, and boilerplate: leaving clean readable markdown that saves 40-60% tokens. Triggers on: defuddle, clean this page, strip this url, fetch and clean, clean web content before ingesting, strip ads, remove clutter, clean URL content, readable markdown from URL.
Create and edit Obsidian Bases (.base files): Obsidian's native database layer for dynamic tables, card views, list views, filters, formulas, and summaries over vault notes. Triggers on: create a base, add a base file, obsidian bases, base view, filter notes, formula, database view, dynamic table, task tracker base, reading list base.
Write correct Obsidian Flavored Markdown: wikilinks, embeds, callouts, properties, tags, highlights, math, and canvas syntax. Reference this when creating or editing any wiki page. Triggers on: write obsidian note, obsidian syntax, wikilink, callout, embed, obsidian markdown, wikilink format, callout syntax, embed syntax, obsidian formatting, how to write obsidian markdown.
Apply the 10-principle thinking loop (OBSERVE-OBSERVE-LISTEN-THINK-CONNECT-CONNECT-FEEL-ACCEPT-CREATE-GROW) to any non-trivial problem. Walks Claude through external observation, metacognition, active listening, first-principles analysis, lateral connection, system orchestration, intuition, intellectual humility, generative output, and iterative growth. Triggers on: think this through, 10-principle review, /think, OBSERVE LISTEN THINK, deep think, systematic thinking, structured reasoning, walk this through, audit my thinking, am I thinking about this right.
Default vault-mutation transport for claude-obsidian v1.7+. Wraps the Obsidian CLI (Obsidian 1.12+) as the preferred way to read, write, search, and modify vault notes from Claude — no MCP server, no REST API plugin, no TLS workarounds. Falls back to direct filesystem Read/Write/Edit when the CLI is unavailable. Triggers on: wiki-cli, obsidian cli, obsidian read, obsidian write, obsidian search, daily note, obsidian create, obsidian append, vault transport, which transport, transport detection, obsidian command line.
Rollup of wiki log entries into meta-pages. Reads the last 2^k entries from wiki/log.md, writes a structurally-idempotent fold page to wiki/folds/ that links back to children. Extractive summarization (no invention). Dry-run by default, stdout-only; commit mode writes and accepts that the PostToolUse hook auto-commits. Triggers on: fold the log, run a fold, run wiki-fold, log rollup, roll up log entries.
Methodology modes for the Compound Vault. Lets the vault declare an organizational style (LYT / PARA / Zettelkasten / Generic) that wiki-ingest, save, and autoresearch consult before filing new pages. Reads `.vault-meta/mode.json`; defaults to `generic` (v1.6/v1.7 behavior) when absent. Per the May 2026 compass artifact, methodology support was priority gap 5 — no other Claude+Obsidian competitor ships it as a first-class skill. Triggers on: set vault mode, switch to PARA, use LYT, what's my vault mode, zettelkasten setup, wiki mode, methodology mode, change mode, configure mode.
Answer questions using the Obsidian wiki vault. Reads hot cache first, then index, then relevant pages. Synthesizes answers with citations. Files good answers back as wiki pages. Supports quick, standard, and deep modes. Triggers on: what do you know about, query:, what is, explain, summarize, find in wiki, search the wiki, based on the wiki, wiki query quick, wiki query deep.
Hybrid retrieval primitive for the Compound Vault. Replaces the v1.6 static hot→index→drill read order with contextual-prefix + BM25 + cosine-rerank, modeled on Anthropic's Sept 2024 Contextual Retrieval research (35-49-67% retrieval-failure reduction). Opt-in via `bash bin/setup-retrieve.sh`; feature-detected by wiki-query and autoresearch. Triggers on: retrieve, hybrid retrieval, BM25, rerank, contextual retrieval, search the chunks, chunk search, vault search, semantic search, what chunks match, find relevant passages.
Plugins overview
# claude-obsidian: Self-Organizing AI Second Brain for Obsidian + Claude Code <p align="center"> <img src="wiki/meta/claude-obsidian-gif-cover-16x9.gif" alt="claude-obsidian: persistent compounding wiki vault for Claude Code and Obsidian" width="100%" /> </p> [](https://github.com/AgriciDaniel/claude-obsidian/stargazers) [](LICENSE) [](https://github.com/AgriciDaniel/claude-obsidian/releases/latest) [](https://github.com/AgriciDaniel/claude-obsidian/actions/workflows/test.yml) [](https://code.claude.com/docs/en/discover-plugins) [](https://obsidian.md) [](https://agentskills.io) [](https://www.skool.com/ai-marketing-hub-pro) [](https://agricidaniel.com/blog/claude-obsidian-ai-second-brain) Claude + Obsidian knowledge companion and self-organizing AI second brain. A running AI notetaker that builds and maintains a persistent, compounding wiki vault. Every source you add gets integrated. Every question you ask pulls from everything that has been read. Knowledge compounds like interest. Open-source Obsidian AI plugin for AI note-taking, personal knowledge management (PKM), second-brain workflows, and a private Notion alternative. **15 Claude Code skills**, multi-agent support, multi-writer safe (v1.7+), first-class methodology modes (LYT / PARA / Zettelkasten / Generic via v1.8), and the 10-principle thinking framework (v1.9). Based on [Andrej Karpathy's LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f). > **Two ways to get this skill.** Pick the one that fits how you work. > > - 🌐 **Public open-source build** (latest: `v1.9.2`, recommended): the free, MIT-licensed release on [Daniel Agrici's GitHub](https://github.com/AgriciDaniel/claude-obsidian). Open to anyone, no membership required. Ships everything: v1.7 Compound Vault, v1.8 methodology modes, and the v1.9 thinking framework plus audit hardening. > - ⚡ **AI Marketing Hub Pro**: the same MIT-licensed core, plus earliest access to in-development features before they land here, direct collaboration, and the [Pro community](https://www.skool.com/ai-marketing-hub-pro). Pro members install from the [AI Marketing Hub](https://github.com/AI-Marketing-Hub) org mirror (swap note under Option 2 below). > ✨ **v1.7 "Compound Vault" refoundation**: Obsidian CLI as default transport, hybrid retrieval (contextual prefix + BM25 + cosine rerank per [Anthropic's Sept 2024 research](https://www.anthropic.com/news/contextual-retrieval)), per-file advisory locking that closes a latent multi-writer corruption hole, and substrate alignment with [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills). Full guide: [docs/compound-vault-guide.md](docs/compound-vault-guide.md). Optional [DragonScale Memory](docs/dragonscale-guide.md) extension (log folds, deterministic page addresses, semantic tiling lint, boundary-first autoresearch). --- ## Contents - [What It Does](#what-it-does) - [Why claude-obsidian?](#why-claude-obsidian) - [Quick Start](#quick-start) - [Commands](#commands) - [`/wiki`: setup, scaffold, continue](#wiki-setup-scaffold-continue) - [`/autoresearch`: autonomous research loop](#autoresearch-autonomous-research-loop) - [`/canvas`: visual layer](#canvas-visual-layer) - [`/think`: 10-principle thinking loop](#think-10-principle-thinking-loop) - [Methodology Modes (v1.8+)](#methodology-modes-v18) - [Vault Use Cases (v1.0+)](#vault-use-cases-v10) - [Cross-Project Knowledge Base](#cross-project-knowledge-base) - [What Gets Created](#what-gets-created) - [Architecture](#architecture) - [MCP Setup (Optional)](#mcp-setup-optional) - [Plugins](#plugins) - [CSS Snippets](#css-snippets-auto-enabled-by-setup-vaultsh) - [Banner Plugin](#banner-plugin) - [File Structure](#file-structure) - [AutoResearch Configuration](#autoresearch-programmd) - [Seed Vault](#seed-vault) - [Companion: claude-canvas](#companion-claude-canvas) - [FAQ](#faq) - [Requirements](#requirements) - [Uninstall](#uninstall) - [Contributing](#contributing) - [Related Projects](#related-projects) - [Community](#community) - [License](#license) --- ## What It Does ### [YouTube Demo](https://www.youtube.com/watch?v=a2hgayvr-H4) <p align="center"> <img src="wiki/meta/welcome-canvas.gif" alt="claude-obsidian welcome canvas: visual demo of the wiki vault workflow" width="96%" /> </p> You drop sources. Claude reads them, extracts entities and concepts, updates cross-references, and files everything into a structured Obsidian vault. The wiki gets richer with every ingest. You ask questions. Claude reads the hot cache (recent context), scans the index, drills into relevant pages, and synthesizes an answer. It cites specific wiki pages, not training data. You lint. Claude finds orphans, dead links, stale claims, and missing cross-references. Your wiki stays healthy without manual cleanup. At the end of every session, Claude updates a hot cache. The next session starts with full recent context, no recap needed. <p align="center"> <img src="wiki/meta/image-example-graph-view.png" alt="Obsidian graph view showing the claude-obsidian knowledge graph with color-coded nodes for concepts, entities, and sources" width="48%" /> <img src="wiki/meta/image-example-wiki-map-view.png" alt="Wiki Map canvas: visual hub linking domain pages, concepts, and entities" width="48%" /> </p> --- ## Why claude-obsidian? Most Obsidian AI plugins are chat interfaces. They answer questions about your existing notes. claude-obsidian is a knowledge engine. It creates, organizes, maintains, and evolves your notes autonomously. | Capability | claude-obsidian | Smart Connections | Copilot | |---|---|---|---| | **Auto-organize notes** | ✅ Creates entities, concepts, cross-references | ❌ | ❌ | | **Contradiction flagging** | ✅ `[!contradiction]` callouts with sources | ❌ | ❌ | | **Session memory** | ✅ Hot cache persists between conversations | ❌ | ❌ | | **Vault maintenance** | ✅ 8-category lint (orphans, dead links, gaps) | ❌ | ❌ | | **Autonomous research** | ✅ 3-round web research with gap-filling | ❌ | ❌ | | **Methodology modes** | ✅ LYT / PARA / Zettelkasten / Generic (first-class) | ❌ | ❌ | | **Thinking framework** | ✅ 10-principle loop as invocable skill | ❌ | ❌ | | **Multi-model support** | ✅ Claude, Gemini, Codex, Cursor, Windsurf | ❌ Claude only | ✅ Multiple | | **Visual canvas** | ✅ Via [claude-canvas](https://github.com/AgriciDaniel/claude-canvas) | ❌ | ❌ | | **Multi-writer safe** | ✅ Per-file advisory locks (v1.7+) | ❌ | ❌ | | **Query with citations** | ✅ Cites specific wiki pages | ✅ Cites similar notes | ✅ Cites notes | | **Batch ingestion** | ✅ Parallel agents for multiple sources | ❌ | ❌ | | **Open source** | ✅ MIT | ✅ MIT | ⚠️ Freemium | > 📖 **Deep dive:** [I Turned Obsidian Into a Self-Organizing AI Brain](https://agricidaniel.com/blog/claude-obsidian-ai-second-brain). Full breakdown with data visualizations, market context, and workflow demos. --- ## Quick Start > ℹ️ The commands below install the **public open-source build** from `AgriciDaniel/claude-obsidian` (recommended, no membership needed). **AI Marketing Hub Pro members** who want early access to in-development features can swap `AgriciDaniel/claude-obsidian` for `AI-Marketing-Hub/claude-obsidian` (Option 2 also swaps the plugin slug; see the note under that option). ### Option 1: Clone as vault (recommended, full setup in 2 minutes) ```bash git clone https://github.com/AgriciDaniel/claude-obsidian cd claude-obsidian bash bin/setup-vault.sh ``` Open the folder in Obsidian: **Manage Vaults → Open folder as vault → select `claude-obsidian/`**. Open Claude Code in the same folder. Type `/wiki`. > ℹ️ `setup-vault.sh` configures `graph.json` (filter + colors), `app.json` (excludes plugin dirs), and `appearance.json` (enables CSS). Run it once before the first Obsidian open. You get the fully pre-configured graph view, color scheme, and wiki structure out of the box. --- ### Option 2: Install as Claude Code plugin Plugin installation is a two-step process. First add the marketplace catalog, then install the plugin from it. > ℹ️ **Which version are you installing?** > > - **Public (recommended, no membership):** the commands below install the free, MIT-licensed release from [`AgriciDaniel/claude-obsidian`](https://github.com/AgriciDaniel/claude-obsidian). Nothing to sign up for. > - **AI Marketing Hub Pro member?** For early access to in-development features, swap `AgriciDaniel/claude-obsidian` for `AI-Marketing-Hub/claude-obsidian` and the plugin slug `claude-obsidian@agricidaniel-claude-obsidian` for `claude-obsidian@ai-marketing-hub-claude-obsidian`. The org mirror requires an authenticated `gh auth login` (or GitHub PAT) with access to the `AI-Marketing-Hub` org. If `/plugin marketplace add` returns a 404, your account is not in the org yet. DM in the [Skool community](https://www.skool.com/ai-marketing-hub-pro) to get added. ```bash # Step 1: add the marketplace claude plugin marketplace add AgriciDaniel/claude-obsidian # Step 2: install the plugin claude plugin install claude-obsidian@agricidaniel-claude-obsidian ``` In any Claude Code session: `/wiki`. Claude walks you through vault setup. To check it worked: ```bash claude plugin list ``` --- ### Option 3: Add to a
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 6.6k GitHub stars and was last updated 16d ago.
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 95/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 from 16d ago, with 68 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.
Deploy claude-obsidian to your cloud
Ship this repo to production in minutes. Each platform spins up its own environment with editable env vars.
Maintain this repo? Add a badge to your README
Drop the badge into your GitHub README to show it's tracked on ClaudeWave. Each badge links back to this page and reflects the live Trust Score.
[](https://claudewave.com/repo/agricidaniel-claude-obsidian)<a href="https://claudewave.com/repo/agricidaniel-claude-obsidian"><img src="https://claudewave.com/api/badge/agricidaniel-claude-obsidian" alt="Featured on ClaudeWave: AgriciDaniel/claude-obsidian" width="320" height="64" /></a>More Plugins
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
Academic Research Skills for Claude Code: research → write → review → revise → finalize
A Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress
Create beautiful slides on the web using a coding agent's frontend skills
PM Skills Marketplace: 100+ agentic skills, commands, and plugins — from discovery to strategy, execution, launch, and growth.
A 100% free modern JS SaaS boilerplate (React, NodeJS, Prisma). Full-featured: Auth (email, google, github, slack, MS), Email sending, Background jobs, Landing page, Payments (Stripe, Polar.sh), Shadcn UI, S3 file upload. AI-ready with tailored AGENTS.md, skills, and Claude Code plugin. One cmd deploy. Powered by Wasp full-stack framework.