claude-obsidian
NewClaude + Obsidian knowledge companion. Sets up a persistent, compounding wiki vault. Covers memory management, session notetaking, knowledge organization, and agent context across projects. Optional DragonScale Memory extension adds hierarchical log folds, deterministic page addresses, embedding-based semantic tiling lint, and boundary-first autoresearch topic selection.
Overview
<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>
        
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.
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. 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. Pro members install from the 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), per-file advisory locking that closes a latent multi-writer corruption hole, and substrate alignment with kepano/obsidian-skills. Full guide: docs/compound-vault-guide.md. Optional DragonScale Memory extension (log folds, deterministic page addresses, semantic tiling lint, boundary-first autoresearch).
Contents
- `/wiki`: setup, scaffold, continue - `/autoresearch`: autonomous research loop - `/canvas`: visual layer - `/think`: 10-principle thinking loop
- โขMethodology Modes (v1.8+)
- โขVault Use Cases (v1.0+)
- โขCross-Project Knowledge Base
- โขWhat Gets Created
- โขArchitecture
- โขMCP Setup (Optional)
- โขPlugins
- โขCSS Snippets
- โขBanner Plugin
- โขFile Structure
- โขAutoResearch Configuration
- โขSeed Vault
- โขCompanion: claude-canvas
- โขFAQ
- โขRequirements
- โขUninstall
- โขContributing
- โขRelated Projects
- โขCommunity
- โขLicense
What It Does
YouTube Demo
<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 | โ | โ |
| 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. 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 swapAgriciDaniel/claude-obsidianforAI-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)
git clone https://github.com/AgriciDaniel/claude-obsidian
cd claude-obsidian
bash bin/setup-vault.shOpen the folder in Obsidian: Manage Vaults โ Open folder as vault โ select `claude-obsidian/`.
Open Claude Code in the same folder. Type /wiki.
โน๏ธ
setup-vault.shconfiguresgraph.json(filter + colors),app.json(excludes plugin dirs), andappearance.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`. Nothing to sign up for.
- AI Marketing Hub Pro member? For early access to in-development features, swap
AgriciDaniel/claude-obsidianforAI-Marketing-Hub/claude-obsidianand the plugin slugclaude-obsidian@agricidaniel-claude-obsidianforclaude-obsidian@ai-marketing-hub-claude-obsidian. The org mirror requires an authenticatedgh auth login(or GitHub PAT) with access to theAI-Marketing-Huborg. If/plugin marketplace addreturns a 404, your account is not in the org yet. DM in the Skool community to get added.
# Step 1: add the marketplace
claude plugin marketplace add AgriciDaniel/claude-obsidian
# Step 2: install the plugin
claude plugin install claude-obsidian@agricidaniel-claude-obsidianIn any Claude Code session: /wiki. Claude walks you through vault setup.
To check it worked:
claude plugin listOption 3: Add to an existing vault
Copy WIKI.md into your vault root. Paste into Claude:
Read WIKI.md in this project. Then:
1. Check if Obsidian is installed. If not, install it.
2. Check if the Local REST API plugin is running on port 27124.
3. Configure the MCP server.
4. Ask me ONE question: "What is this vault for?"
Then scaffold the full wiki structure.Commands
| You say | Claude does |
|---|---|
/wiki | Setup check, scaffold, or continue where you left off |
ingest [file] | Read source, create 8-15 wiki pages, update index and log |
ingest all of these | Batch process multiple sources, then cross-reference |
what do you know about X? | Read index, drill into relevant pages, synthesize answer |
/save | File the current conversation as a wiki note |
/save [name] | Save with a specific title (skips the naming question) |
/autoresearch [topic] | Run the autonomous research loop: search, fetch, synthesize, file |
/canvas | Open or create the visual canvas, list zones and nodes |
/canvas add image [path] | Add an image (URL or local path) to the canvas with auto-layout |
/canvas add text [content] | Add a markdown text card to the canvas |
/canvas add pdf [path] | Add a PDF document as a rendered preview node |
/canvas add note [page] | Pin a wiki page as a linked card on the canvas |
/canvas zone [name] | Add a new labeled zone to organize visual content |
/canvas from banana | Capture recently generated images onto the canvas |
/think [problem] | Apply the 10-principle thinking loop to a non-trivial problem |
lint the wiki | Health check: orphans, dead links, gaps, suggestions |
update hot cache | Refresh hot.md with latest context summary |
โจ Want more? claude-canvas adds 12 templates, 6 layout algorithms, AI image generation, presentations, and full canvas orchestration. Install both, they complement each other.
/wiki: setup, scaffold, continue
First-run setup walks through:
- Check Obsidian is installed
- Check Local REST API plugin (if MCP transport desired)
- Ask "What is this vault for?" (one question, drives the scaffold)
- Scaffold per chosen Methodology Mode and Vault Use Case
- Seed
hot.md,index.md,log.md,wiki/meta/dashboard.base - Suggest the first ingest
On subsequent runs, /wiki continues where you left off. It checks vault health, surfaces stale claims, and shows recent activity from hot.md.
/autoresearch: autonomous research loop
Configurable program at `skills/autoresearch/references/program.md`:
- โขMax rounds (default 3)
- โขMax pages per session (default 15)
- โขSource preference rules (academic, official docs, news)
- โขConfidence scoring + domain constraints
The loop:
- Round 1, broad search: decompose into 3-5 angles, run 2-3 queries per angle, fetch top 2-3 results per angle
- Round 2, gap fill: targeted searches for contradictions and missing pieces
- Round 3, synthesis check (optional): one more pass if major gaps remain
- Filing: synthesis page + source pages + entity pages + concept pages, all cross-referenced
URL validation + content sanitization applied per the ## Web egress hygiene (v1.8.2+) policy in `skills/autoresearch/SKILL.md`: rejects file:// / javascript: / RFC1918 hosts, strips <script> and wikilink-injection attempts, caps fetch bodies at 50KB.
/canvas: visual layer
Add images, PDFs, notes, and AI-generated images to an Obsidian canvas. Zone management for grouping. Auto-layout positions nodes without overlap.
/canvas # open or create the canvas
/canvas add image <path> # add an image with auto-layout
/canvas add pdf <path> # render PDF as preview node
/canvas add note <wiki-page> # pin a wiki page as a linked card
/canvas zone <name> # add a labeled zone
/canvas from banana # capture recent banana-generated imagesJSON Canvas 1.0 spec compliant (`skills/canvas/references/canvas-spec.md`). Full orchestration (12 templates, 6 layout algorithms, presentations) in the companion claude-canvas.
/think: 10-principle thinking loop
Apply the OBSERVE-OBSERVE-LISTEN-THINK-CONNECT-CONNECT-FEEL-ACCEPT-CREATE-GROW framework to any non-trivial problem (architectural decisions, audits, post-mortems, ambiguous user requests).
/think <problem statement>The framework walks Claude through 10 stages with prompts at each. Use when problem novelty + irreversibility justify the discipline. See `skills/think/SKILL.md` for the full framework. Every other skill has a "How to think" appendix mapping the framework to its specific work. The v1.8.0 pre-push audit used this framework as its methodology spine.
Methodology Modes (v1.8+)
Four organizational philosophies, opt-in via bash bin/setup-mode.sh. The wiki-mode skill (v1.8+) reads .vault-meta/mode.json and routes new pages accordingly. Default is generic (v1.7 behavior, no opinion imposed).
| Mode | Philosophy | Filing convention |
|---|---|---|
| Generic (default) | No opinion. v1.7 behavior preserved. | wiki/sources/, wiki/entities/, wiki/concepts/, wiki/sessions/ |
| LYT (Linking Your Thinking) | Notes link, folders don't. MOCs are the navigation primitive. | wiki/mocs/<topic>-moc.md + wiki/notes/<atomic-note>.md |
| PARA (Tiago Forte) | Organize by actionability (Projects, Areas, Resources, Archives). | wiki/projects/, wiki/areas/, wiki/resources/, wiki/archives/ |
| Zettelkasten (Luhmann slip-box) | Atomic notes, unique IDs, dense bidirectional linking, no folders. | wiki/<YYYYMMDDHHMMSSffffff>-<slug>.md (flat, timestamped) |
Switching modes does NOT auto-migrate existing files. Full guide: `docs/methodology-modes-guide.md`.
Vault Use Cases (v1.0+)
These describe what your vault is for. They compose with Methodology Modes (which describe how it is organized).
| Use case | When to use |
|---|---|
| A: Website | Sitemap, content audit, SEO wiki |
| B: GitHub | Codebase map, architecture wiki |
| C: Business | Project wiki, competitive intelligence |
| D: Personal | Second brain, goals, journal synthesis |
| E: Research | Papers, concepts, thesis |
| F: Book/Course | Chapter tracker, course notes |
Use cases can be combined. A Business + Research vault organized in PARA is a valid composition.
Cross-Project Knowledge Base
Point any Claude Code project at this vault. Add to that project's CLAUDE.md:
## Wiki Knowledge Base
Path: ~/path/to/vault
When you need context not already in this project:
1. Read wiki/hot.md first (recent context cache)
2. If not enough, read wiki/index.md
3. If you need domain details, read the relevant domain sub-index
4. Only then drill into specific wiki pages
Do NOT read the wiki for general coding questions or tasks unrelated to [domain].Your executive assistant, coding projects, and content workflows all draw from the same knowledge base.
What Gets Created
A typical scaffold creates:
- โขFolder structure for your chosen use case + methodology mode
- โข
wiki/index.md: master catalog - โข
wiki/log.md: append-only operation log - โข
wiki/hot.md: recent context cache - โข
wiki/overview.md: executive summary - โข
wiki/meta/dashboard.base: Bases dashboard (primary, native Obsidian) - โข
wiki/meta/dashboard.md: Legacy Dataview dashboard (optional fallback) - โข
_templates/: Obsidian Templater templates for each note type - โข
.obsidian/snippets/vault-colors.css: color-coded file explorer - โขVault
CLAUDE.md: auto-loaded project instructions
Architecture
Three diagrams explain the substantive design choices of the plugin.
Vault flow
Sources land in .raw/. The /wiki-ingest agent reads each source, extracts entities and concepts, files them into the appropriate wiki/ subfolder (per active methodology mode), and updates the index, log, and hot cache. Queries read hot โ index โ pages in that order to keep token cost low.
<p align="center"> <img src="assets/diagrams/vault-flow.svg" alt="Architecture diagram: sources flow into the wiki-ingest agent, which produces entity, concept, and source pages. The index and hot cache are updated. The wiki-query interface reads the cache, index, and pages to synthesize cited answers." width="100%" /> </p>
Multi-writer safety (v1.7+)
Parallel ingest sub-agents can target the same wiki page if the user batches multiple sources. scripts/wiki-lock.sh provides per-file advisory locks: one writer acquires, the other waits and retries on the next pass. The PostToolUse auto-commit hook checks the lock list before staging, deferring the commit while writes are in flight.
<p align="center"> <img src="assets/diagrams/multi-writer-locking.svg" alt="Architecture diagram: two parallel writers attempt to acquire a lock on the same wiki page via wiki-lock.sh. One writer is granted, writes the page, and releases the lock. The other writer logs the skip and retries on the next pass. No corruption, no half-written pages." width="100%" /> </p>
Hybrid retrieval (v1.7+, opt-in)
The /wiki-retrieve skill ships a three-tier retrieval pipeline based on Anthropic's Sept 2024 contextual retrieval research. BM25 is the always-on sparse layer. The contextual-prefix tier is consent-gated (--allow-egress) for users who want to send page bodies to the Anthropic API for prefix generation. Cosine rerank uses a local ollama model by default. The 50-query benchmark in v1.7 measured +32 percentage points top-1 accuracy and +41 percent error reduction vs the v1.6 baseline.
<p align="center"> <img src="assets/diagrams/hybrid-retrieval.svg" alt="Architecture diagram: user query feeds both BM25 sparse search and an optional contextual-prefix Anthropic API call. Both feed a cosine rerank via local ollama embeddings. The output is a ranked list of candidates with --explain traceability for every score." width="100%" /> </p>
โน๏ธ Provision the pipeline with
bash bin/setup-retrieve.sh. It builds the BM25 index, prompts for egress consent, and validates the ollama connection. The pipeline degrades gracefully: if any tier is unavailable, the rest still return useful results.
MCP Setup (Optional)
MCP lets Claude read and write vault notes directly without copy-paste.
Option A (REST API based):
- Install the Local REST API plugin in Obsidian
- Copy your API key
- Run:
claude mcp add-json obsidian-vault '{
"type": "stdio",
"command": "uvx",
"args": ["mcp-obsidian"],
"env": {
"OBSIDIAN_API_KEY": "your-key",
"OBSIDIAN_HOST": "127.0.0.1",
"OBSIDIAN_PORT": "27124",
"NODE_TLS_REJECT_UNAUTHORIZED": "0"
}
}' --scope userOption B (filesystem based, no plugin needed):
claude mcp add-json obsidian-vault '{
"type": "stdio",
"command": "npx",
"args": ["-y", "@bitbonsai/mcpvault@latest", "/path/to/your/vault"]
}' --scope userโน๏ธ Both transports are auto-detected by
scripts/detect-transport.sh. The result lands in.vault-meta/transport.json. To pin a manual choice, edit that file and set"manual_override": true(v1.8.2+ honors it).
Plugins
Core Plugins (built into Obsidian, no install needed)
| Plugin | Purpose |
|---|---|
| Bases | Powers wiki/meta/dashboard.base: native database views. Available since Obsidian v1.9.10 (August 2025). Replaces Dataview for the primary dashboard. |
| Properties | Visual frontmatter editor |
| Backlinks, Outline, Graph view | Standard navigation |
Pre-installed Community Plugins (ship with this vault)
Enable in Settings โ Community Plugins โ enable:
| Plugin | Purpose | Notes |
|---|---|---|
| Calendar | Right-sidebar calendar with word count + task dots | Pre-installed |
| Thino | Quick memo capture panel | Pre-installed |
| Excalidraw | Freehand drawing canvas, annotate images | Pre-installed* |
| Banners | Notion-style header image via banner: frontmatter | Pre-installed |
\* Excalidraw main.js (8MB) is downloaded automatically by setup-vault.sh. It is not tracked in git.
Also install from Community Plugins (not pre-installed)
| Plugin | Purpose |
|---|---|
| Templater | Auto-fills frontmatter from _templates/ |
| Obsidian Git | Auto-commits vault every 15 minutes |
| Dataview (optional, legacy) | Only needed for the legacy wiki/meta/dashboard.md queries. The primary dashboard now uses Bases. |
Also install the [Obsidian Web Clipper](https://obsidian.md/clipper) browser extension. Sends web pages to .raw/ in one click.
CSS Snippets (auto-enabled by setup-vault.sh)
Three snippets ship with the vault and are enabled automatically:
| Snippet | Effect | |
|---|---|---|
vault-colors | Color-codes wiki/ folders by type in the file explorer (blue = concepts, green = sources, purple = entities) | |
ITS-Dataview-Cards | Turns Dataview TABLE queries into visual card grids: use `dataviewjs with .cards class | |
ITS-Image-Adjustments | Fine-grained image sizing in notes: append `\ | 100` to any image embed |
Banner Plugin
Add to any wiki page frontmatter:
banner: "_attachments/images/your-image.png"
banner_icon: "๐ง "The page renders a full-width header image in Obsidian. Works great for hub pages and overviews.
File Structure
claude-obsidian/
โโโ .claude-plugin/
โ โโโ plugin.json # manifest
โ โโโ marketplace.json # distribution
โโโ skills/ # 15 Claude Code skills (v1.9.2)
โ โโโ wiki/ # orchestrator + references
โ โโโ wiki-ingest/ # source ingestion
โ โโโ wiki-query/ # answer questions from the vault
โ โโโ wiki-lint/ # vault health check
โ โโโ wiki-cli/ # Obsidian CLI transport (v1.7+)
โ โโโ wiki-retrieve/ # hybrid retrieval (v1.7+, opt-in)
โ โโโ wiki-mode/ # methodology modes router (v1.8+)
โ โโโ wiki-fold/ # log rollup (DragonScale opt-in)
โ โโโ save/ # /save: file conversations to wiki
โ โโโ autoresearch/ # autonomous research loop
โ โโโ canvas/ # visual layer (images, PDFs, notes)
โ โโโ defuddle/ # web extraction wrapper
โ โโโ obsidian-bases/ # Bases schema reference
โ โโโ obsidian-markdown/ # OFM syntax reference
โ โโโ think/ # 10-principle thinking framework (v1.9+)
โโโ agents/
โ โโโ verifier.md # pre-commit audit agent (v1.7.1+)
โ โโโ wiki-ingest.md # parallel batch ingestion agent
โ โโโ wiki-lint.md # health check agent
โโโ commands/ # slash command entry points
โโโ hooks/
โ โโโ hooks.json # SessionStart + Stop + PostToolUse hooks
โโโ scripts/ # 12 helper scripts (transport, locking, retrieval, etc.)
โโโ tests/ # 9 hermetic test suites (~1240 assertions, make test)
โโโ bin/ # 5 setup scripts (setup-vault, setup-retrieve, setup-mode, etc.)
โโโ _templates/ # Obsidian Templater templates
โโโ wiki/ # seeded vault content (demo)
โ โโโ canvases/ # welcome.canvas + main.canvas
โ โโโ concepts/ # seeded: LLM Wiki Pattern, Hot Cache, Compounding Knowledge
โ โโโ entities/ # seeded: Andrej Karpathy
โ โโโ sources/ # populated by your first ingest
โ โโโ meta/
โ โโโ dashboard.base # Bases dashboard (primary)
โ โโโ dashboard.md # Legacy Dataview dashboard (optional)
โโโ docs/ # guides + audits + release notes
โโโ .raw/ # source documents (hidden in Obsidian)
โโโ .obsidian/snippets/ # vault-colors.css (3-color scheme)
โโโ WIKI.md # full schema reference
โโโ CLAUDE.md # project instructions
โโโ README.md # this fileAutoResearch: program.md
The /autoresearch command is configurable. Edit `skills/autoresearch/references/program.md` to control:
- โขWhat sources to prefer (academic, official docs, news)
- โขConfidence scoring rules
- โขMax rounds and max pages per session
- โขDomain-specific constraints
The default program works for general research. Override it for your domain. A medical researcher would add "prefer PubMed". A business analyst would add "focus on market data and filings".
Seed Vault
This repo ships with a seeded vault. Open it in Obsidian and you will see:
- โข
wiki/concepts/: LLM Wiki Pattern, Hot Cache, Compounding Knowledge - โข
wiki/entities/: Andrej Karpathy - โข
wiki/sources/: empty until your first ingest - โข
wiki/meta/dashboard.base: Bases dashboard (works in any Obsidian v1.9.10+) - โข
wiki/meta/dashboard.md: Legacy Dataview dashboard (optional fallback)
The graph view will show a connected cluster of 5 pages. This is what the wiki looks like after one ingest. Add more sources and it grows from there.
<p align="center"> <img src="wiki/meta/wiki-graph-grow.gif" alt="Animated GIF: claude-obsidian knowledge graph growing from a few seeded pages to a dense web of cross-referenced concepts after multiple ingests" width="48%" /> <img src="wiki/meta/workflow-loop.gif" alt="Animated GIF: claude-obsidian workflow loop showing ingest, query, lint, save, and hot-cache refresh cycle" width="48%" /> </p>
Companion: claude-canvas
For the visual layer, claude-canvas adds AI-orchestrated canvas creation: knowledge graphs, presentations, flowcharts, mood boards with 12 templates and 6 layout algorithms. Auto-detects claude-obsidian vaults.
claude plugin install AgriciDaniel/claude-canvasFAQ
What is the best AI second brain app? The best AI second brain keeps your data yours. claude-obsidian stores everything as plain Markdown files you own (no database, no lock-in, no subscription) and lets Claude read, link, and organize them into one connected knowledge graph. It is free and open source (MIT).
How do I build a second brain with AI? Drop any source into the vault. Claude reads it, extracts the entities and concepts, links them to what you already have, and files it into a structured Obsidian vault. You ask questions; it answers from everything it has read and cites the pages. The knowledge base gets richer and more connected with every session.
How do I connect Claude to Obsidian as a second brain? Two lines: git clone https://github.com/AgriciDaniel/claude-obsidian, then cd claude-obsidian && bash bin/setup-vault.sh. Open the folder as an Obsidian vault, open Claude Code in the same folder, and type /wiki. Full steps in Quick Start.
Is there a good Notion alternative for a private, AI-powered knowledge base? Yes. claude-obsidian is an open-source, local-first alternative: your notes are plain Markdown on your own disk instead of a hosted database, and AI organizes them for you. No vendor lock-in and no monthly fee.
Does this auto-sync across devices? Not on its own. The vault is a plain folder of Markdown files. Pair with Obsidian Sync, Obsidian Git, or any file-sync tool (Syncthing, iCloud, Dropbox) for cross-device sync.
Can multiple people edit the same vault safely? Yes (v1.7+). Per-file advisory locking via `scripts/wiki-lock.sh` prevents concurrent writes from corrupting pages. Parallel ingest sub-agents acquire locks before writes. Stale locks self-reap after 60 seconds.
What is the difference between `hot.md` and `index.md`? hot.md is the recent-context cache (~500 words, refreshed each session). index.md is the master catalog of every page in the vault. Claude reads hot.md first, then index.md, then drills into specific pages. The two-layer design keeps token cost low for repeat queries.
Can I use this without Claude Code? The skills are Agent Skills compatible (experimental support for OpenAI Codex CLI, Cursor, Windsurf, Gemini CLI, Goose). Production verification is only on Claude Code today. Cross-host install paths follow each host's conventions but skill discovery may differ.
How do I migrate from Dataview to Bases? Both ship side-by-side. wiki/meta/dashboard.base is the primary; wiki/meta/dashboard.md is the legacy Dataview fallback. Pick one in Obsidian, the other is harmless. Bases requires Obsidian v1.9.10+ (August 2025).
What is the difference between Methodology Modes (LYT/PARA/Zettelkasten) and Vault Use Cases (Website/GitHub/Business)? Methodology Modes (v1.8+) control how pages are organized: folder structure + filename conventions. Vault Use Cases (v1.0+) describe what the vault is for: content type. They compose. A "Business" vault using PARA methodology is a valid configuration.
Does this send my notes to Anthropic? No by default. The optional /wiki-retrieve skill has API egress (contextual-prefix.py) gated behind the --allow-egress consent flag. Without that flag, retrieval is fully local (BM25 + optional ollama rerank). Web egress in /autoresearch follows the same opt-in principle.
What is the difference between the public build and AI Marketing Hub Pro? Both share the same MIT-licensed core on `AgriciDaniel/claude-obsidian`, which is the recommended install for everyone. AI Marketing Hub Pro members get earliest access to in-development features before they ship here, plus direct collaboration and the community. There are no paid-only features in the core.
What is DragonScale Memory? An optional opt-in extension (bash bin/setup-dragonscale.sh) that adds four memory mechanisms: log folds (rollup of past entries), deterministic page addresses (counter-based unique IDs), semantic tiling lint (chunk-boundary validation via ollama), and boundary-first autoresearch (research the vault's "frontier" first). Not required for normal use. Full guide: `docs/dragonscale-guide.md`.
Requirements
| Component | Minimum | Notes |
|---|---|---|
| Claude Code | latest | https://claude.com/claude-code |
| Obsidian | v1.9.10+ (for Bases) | https://obsidian.md. v1.6+ works with Dataview fallback. |
| Python | 3.10+ | For the optional retrieval pipeline and the test suite |
| Bash | 4.0+ (or zsh) | For setup scripts |
| Git | any | For vault auto-commits via the Obsidian Git plugin |
Optional:
- โขollama (for local rerank in
/wiki-retrieve) - โขdefuddle-cli (for clean web extraction in
/defuddle) - โขAnthropic API key (for
/wiki-retrievecontextual prefix tier, opt-in via--allow-egress) - โขLocal REST API plugin (for the REST-API MCP transport)
Uninstall
Plugin install:
claude plugin uninstall claude-obsidian@agricidaniel-claude-obsidian
claude plugin marketplace remove AgriciDaniel/claude-obsidianClone install (delete the folder):
rm -rf /path/to/claude-obsidianYour vault content (under wiki/) is plain Markdown and survives uninstall. To clear the runtime state without uninstalling, run make clean-test-state from the repo root.
Contributing
PRs welcome. Read these first:
- โข`CONTRIBUTING.md`: workflow, six-cut self-review checklist, commit conventions, hermetic test requirements
- โข`CODE_OF_CONDUCT.md`: Contributor Covenant v2.1
- โข`SECURITY.md`: responsible security disclosure policy
- โข`CHANGELOG.md`: version history (latest: v1.9.2)
Issue + PR templates available under `.github/`. CI runs make test + SKILL.md frontmatter validation + plugin manifest JSON validity on every PR. The pre-commit verifier agent at `agents/verifier.md` applies the six-cut + agent kernel to staged diffs.
Related Projects
- โข๐จ **claude-canvas**: visual canvas orchestration (12 templates, 6 layout algorithms, AI image generation). Companion to this plugin.
- โข๐ **claude-ads**: multi-platform paid advertising audit (250+ checks across Google, Meta, LinkedIn, TikTok, Microsoft, Apple, Amazon Ads).
- โข๐ **claude-seo**: technical SEO + GEO audit suite.
- โข๐ง **best-practices**: composable engineering kernel. Source for the six-cut + agent kernel that
agents/verifier.mdenforces.
Community
- โข๐ **Blog post**: deep dive with competitor analysis, data charts, and workflow demos
- โข๐ฌ **AI Marketing Hub**: 2,800+ members, free community
- โขโก **AI Marketing Hub Pro**: early access to in-development features and direct collaboration
- โข๐ฌ **YouTube**: tutorials and demos
- โข๐ง **All open-source tools**: claude-seo, claude-ads, claude-blog, and more
License
MIT License. See LICENSE for full text. Free for personal and commercial use. Attribution appreciated but not required.
Star History
<a href="https://star-history.com/#AgriciDaniel/claude-obsidian&Date"> <img src="https://api.star-history.com/svg?repos=AgriciDaniel/claude-obsidian&type=Date" alt="Star history chart for AgriciDaniel/claude-obsidian on GitHub" width="640" /> </a>
Based on [Andrej Karpathy's LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f). Built by [Agrici Daniel](https://agricidaniel.com/about). Compounding knowledge is the highest-leverage habit a thinking person can build.
Install & Usage
/plugin marketplace add <org/repo>Add the configuration to /plugin install claude-obsidian@<marketplace>
/pluginSecurity Audits
Frequently Asked Questions
What is claude-obsidian?
Claude + Obsidian knowledge companion. Sets up a persistent, compounding wiki vault. Covers memory management, session notetaking, knowledge organization, and agent context across projects. Optional DragonScale Memory extension adds hierarchical log folds, deterministic page addresses, embedding-based semantic tiling lint, and boundary-first autoresearch topic selection.
How to install claude-obsidian?
To install claude-obsidian: add a marketplace (/plugin marketplace add <org/repo>), then add the config to /plugin install claude-obsidian@<marketplace>. Finally, /plugin in Claude Code.
What is claude-obsidian best for?
claude-obsidian is a plugin categorized under General. It is designed for: agent. Created by AgriciDaniel.