AgriciDaniel/claude-obsidian
An open-source second brain that lets Claude Code file your notes into Obsidian while you keep full ownership of the files
claude-obsidian is an open-source tool that works with Claude Code to read source material, summarize it, and organize it into an Obsidian vault made of plain Markdown files. It runs a repeatable loop of capturing, grounding claims in evidence, linking notes, and reusing what's already known, with every file change requiring an explicit review-and-approve step before it's applied. It's built on the design pattern Andrej Karpathy described as the 'LLM Wiki'.
What it does
- What: drop any source material into the system and Claude reads it, then files it into linked Markdown pages inside your own Obsidian vault
- How: you place a file in the inbox folder and run wiki-ingest to turn it into linked, source-cited pages; wiki-query then answers questions using only evidence already stored in the vault
- Safety: every write operation must be previewed as a plan, approved via a SHA-256 hash, and only then applied; if an operation is interrupted, the system restores the prior state
- Structure: the system is split into 15 skills, including wiki (setup/routing), save, wiki-lint (health checks), wiki-retrieve (search), and canvas (visual mapping)
- Result: the vault always stays a normal folder of Markdown files rather than being locked into a cloud database, and unsupported or contradictory claims are kept visible instead of hidden
Why it matters
It offers a concrete alternative for people who want AI help organizing notes but don't want to give up ownership of their files or lose track of where claims came from. It's a useful reference architecture for developers or researchers who want a local, self-managed 'second brain' instead of relying on a cloud note app.
Terms in this repo
- Obsidian · a local note-taking app that stores notes as Markdown files and links them into a graph
- vault · the folder of note files that Obsidian manages
- BM25 · a classic keyword-matching search algorithm used to rank documents
- SHA-256 · a hash function that converts data into a fixed value used to verify it hasn't changed
- Agent Skills · a standard format defining discrete tasks an AI agent can perform
Repository description (English)
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.
Open on GitHubTrending repos
- vorssaint/vorssaint-utilsOne free menu bar app replaces a dozen paid Mac utilities
- MadsLorentzen/ai-job-searchAn open-source framework that runs your entire job search through Claude Code, built by someone who actually got hired using it
- rohitg00/ai-engineering-from-scratchA free hands-on curriculum that teaches AI by having you build every piece from scratch, from math to shippable agents
- openclaw/openclawA personal AI assistant that lives on your own devices and talks to you through the messaging apps you already use
- tashfeenahmed/freellmapiAn open-source router that stitches 34 free LLM tiers into one API key so your app never hits a rate limit
- Alishahryar1/free-claude-codeA local proxy that lets coding AI agents run on 49 free or cheap model providers instead of one paid service
- freestylefly/awesome-gpt-image-2A library of 532 reverse-engineered prompts that turn GPT-Image2 into a predictable image-making tool
- block/buzzAn open-source workspace where humans and AI agents chat, code, and review in the same rooms
Latest from METAL LAB
- ChatGPT Work now turns spoken thoughts into finished documents
- 100-Rally Match Against World No. 15... The Robot on Court Was Unveiled Three Days Earlier
- Robot 100m in 9.32 Seconds Beats Bolt in Heats, But Foam Pads Wait at the Finish Line
- NVIDIA in talks to invest in Perplexity at $30 billion-plus valuation
- Inside Sakana AI — the $2.7 billion company a Transformer author built in Tokyo