claude-obsidian plugin
A plugin and skill set that turns an Obsidian vault into a knowledge base with sources, links and grounded answers
- 15,977 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Writes files to the vault and runs Python scripts
- The autoresearch skill uses the web after consent
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/claude-obsidianDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Writes files to the vault and runs Python scripts
- The autoresearch skill uses the web after consent
This is third-party code. Review the repository files before installing.
What it does
The plugin runs a wiki in a normal Obsidian vault following Karpathy's LLM Wiki pattern. Sources go into an inbox, the agent keeps immutable copies, creates linked pages and maintains source and claim ledgers that flag contradictions. You can then query the vault, search with BM25, lint dead links and orphans, build Canvas maps and run bounded web research with a separate merge. Every write is one recoverable transaction with a preview, and network or destructive actions need explicit consent. It ships 15 skills, including PARA, LYT and Zettelkasten modes.
Who it is for. For researchers, analysts and anyone keeping a personal Obsidian knowledge base who wants the agent to fill it with cited sources.
Good fit when
- You need to turn articles and notes into a linked, cited wiki
- You want answers grounded only in what is already in the vault
- You need regular cleanup of dead links and stale pages
Not a fit when
- You want automatic transcript capture or cloud sync
- You do not use Obsidian and do not want Markdown files
Example request
Ingest the new files from inbox into the wiki with source citationsLimitations
Setup is heavier than a typical skill: clone the repo, initialize a vault with a Python script confirming the plan hash, and run Claude Code with --plugin-dir. PDF and EPUB content is not extracted yet; URL, YouTube and OCR need an external runner. Not a substitute for backups.
How to disable. Run Claude Code without --plugin-dir or remove the plugin via /plugin. The vault stays a plain folder of files.
FAQ
Are my notes uploaded?
No, the vault stays local and network requests happen only with explicit consent.
Can I use an existing vault?
Yes, the non-destructive adopt command is covered in the install guide.
Discussion
No questions or reviews yet.
Related
PluginsA skill set that lets an agent run a personal Obsidian wiki: it compiles knowledge from documents and past sessions and answers with citations
A Claude Code plugin that builds a knowledge system of markdown files from a conversation with you: folder structure, note templates, a processing pipeline and
Persistent agent memory in an Obsidian vault: saving decisions, search, research and background vault upkeep
Four skills for a personal Obsidian knowledge base: an agent compiles articles and notes into a linked wiki, answers from it and health-checks it
An Obsidian vault template with hooks, commands and skills that gives Claude Code, Codex and Gemini CLI persistent memory across sessions
An Obsidian vault template for Claude Code: /daily, /weekly, /monthly and /project commands link three-year goals to today's tasks
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Repository stars | Main difference |
|---|---|---|---|
| claude-obsidian (this entry) | no | 15,977 | |
| Second Brain OS | no | 1,160 | an Obsidian vault template with 18 skills |
| RedNote to Obsidian | no | 428 | a Claude Code plugin that turns RedNote posts with text |
README in short
The README describes a loop: keep the source, ground claims, connect knowledge and reuse it in answers. Quick start is clone, initialize a separate vault with plan review, and run Claude Code with the plugin; a setup script covers Codex, OpenCode and Gemini. It lists the 15 skills, the transaction model and a candid table of supported inputs. It ends with a CLI reference and upgrade and uninstall notes.