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 pat
claude-obsidian is a Claude Code plugin that transforms Obsidian into an AI-powered personal knowledge management system with 15 coordinated skills. It processes sources into linked markdown notes with full provenance tracking, answers queries from vault evidence, and maintains knowledge graph health—all while keeping your data local in plain markdown files you own. The plugin implements a capture-ground-connect-use loop inspired by Andrej Karpathy's LLM Wiki pattern, supporting multiple PKM methodologies (LYT, PARA, Zettelkasten, Generic). Compatible with Claude Code, Codex, OpenCode, Gemini, Cursor, and Windsurf through the Agent Skills protocol.
Key Features
Use Cases
- 01Building a personal knowledge base from research papers, articles, and local documents with automatic linking
- 02Creating a second brain for software development with source-cited technical notes and API references
- 03Managing long-term research projects with provenance-tracked claims and contradiction detection
- 04Converting scattered notes into a structured knowledge graph using LYT, PARA, or Zettelkasten methodologies
- 05Querying existing vault knowledge instead of re-asking Claude the same questions from scratch
- 06Maintaining vault health by detecting dead links, orphaned notes, stale indexes, and unsupported claims
Related Plugins
View moreandrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
claude-mem
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
rtk
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
claude-obsidian — FAQ
What is claude-obsidian and what does it do?+
claude-obsidian is a Claude Code plugin that turns Obsidian into an AI-powered knowledge management system. It captures sources, creates linked notes with provenance tracking, answers queries from vault evidence, and maintains knowledge graph health while keeping all data local in plain markdown files.
How do I install the claude-obsidian plugin for Claude Code?+
Clone the repository, initialize a separate vault using the Python setup script with preview-and-approve workflow, then run Claude Code from your vault directory with the --plugin-dir flag pointing to the cloned repo. For other hosts like Codex or Cursor, use the portable skill setup scripts provided.
Which AI clients and assistants work with claude-obsidian?+
claude-obsidian works with Claude Code (primary), Codex, OpenCode, Gemini, Cursor, and Windsurf through the Agent Skills protocol. Each host uses its native skill invocation method; setup scripts are provided for multi-agent compatibility.
What are the prerequisites and do I need API keys?+
You need Python 3.11+, Obsidian (recommended but optional for plain markdown), and Bash for setup scripts. No API keys are required for local operation; optional features like remote embeddings or web research require explicit consent and configured external runners.
Is claude-obsidian free and open source?+
Yes, claude-obsidian is free and MIT licensed. All vault data remains local in plain markdown files you own; the plugin never locks knowledge in proprietary formats or cloud databases.
Can I use claude-obsidian with an existing Obsidian vault?+
Yes, use the non-destructive 'adopt' workflow instead of 'init' to add claude-obsidian capabilities to an existing vault. The migration preserves all legacy notes and only adds configuration and ledger files without rewriting existing content.
How do I install claude-obsidian?+
Open the source repository on GitHub and follow its README. claude-obsidian is a plugin — MCP Agents Market links you directly to the official repo.
Is claude-obsidian free?+
claude-obsidian is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.