DEV Community

FatherSon
FatherSon

Posted on

Claude + Obsidian: Build a Self-Maintaining AI Wiki That Compounds Knowledge Forever

Your AI forgets everything the moment you close the chat.

Your Obsidian vault is full of notes you never revisit.

What if those two problems solved each other?

claude-obsidian turns your Obsidian vault into a persistent, self-updating wiki powered by Claude Code. Drop in PDFs, articles, transcripts, or meeting notes, and Claude automatically extracts concepts, creates linked wiki pages, flags contradictions, and maintains context across every future session.

Knowledge compounds like compound interest. Claude never starts from zero again because the system keeps a smart cache of what matters.

Here’s the complete setup guide.

Prerequisites

  1. Obsidian (free)

    Download it and create a new vault (just a folder of Markdown files).

  2. Node.js 18+

    Check with:

   node --version
Enter fullscreen mode Exit fullscreen mode

If needed, install the LTS version.

  1. Claude Code (desktop + CLI version of Claude that can read/write files on your machine).

Step-by-Step Setup

1. Install claude-obsidian

Open Claude Code and navigate into your Obsidian vault folder:

cd path/to/your-vault
Enter fullscreen mode Exit fullscreen mode

Then run:

claude plugin marketplace add AgriciDaniel/claude-obsidian
claude plugin install claude-obsidian@claude-obsidian-marketplace
Enter fullscreen mode Exit fullscreen mode

The plugin automatically copies all required skills into your vault.

2. Initialize the Wiki Structure

Run:

/wiki
Enter fullscreen mode Exit fullscreen mode

Claude will scaffold the complete folder structure:

wiki/
├── concepts/          # Frameworks, patterns, ideas
├── sources/           # Ingested documents
├── entities/          # People, tools, organizations
├── sessions/          # Saved conversations
├── log.md             # Operation history
├── index.md           # One-line summary of every page
└── hot.md             # Session context cache
Enter fullscreen mode Exit fullscreen mode

This becomes your living second brain.

Core Commands

The entire system runs on three main commands:

  • /save

    After any valuable conversation, type /save.

    Claude reads the chat, extracts key ideas, creates properly formatted wiki pages with frontmatter and wikilinks, organizes them into the right folders, and updates the index.

  • /autoresearch [topic]

    Claude runs multiple rounds of web research, synthesizes findings into structured wiki pages with citations, and cross-references them with existing knowledge in your vault.

    You can customize source priorities by editing skills/autoresearch/references/program.md.

  • /canvas [description]

    Claude generates an Obsidian Canvas (infinite visual board) populated with relevant nodes from your wiki. Great for flowcharts, knowledge graphs, timelines, or presentations.

Daily Workflow (The Ingest Loop)

  1. Drop sources into the .raw/ folder (PDFs, articles, transcripts, URLs, notes). This folder is your immutable archive.

  2. Ingest:

   ingest filename-or-content
Enter fullscreen mode Exit fullscreen mode

Claude processes the source, creates 8–15 interconnected wiki pages per typical document, adds wikilinks, flags contradictions with callouts, and logs everything.

  1. Query: 
   what do you know about [topic]?
Enter fullscreen mode Exit fullscreen mode

Claude uses the hot cache + index to pull relevant pages and answers with citations back to your own organized knowledge.

Why It Scales Efficiently

Even with thousands of pages, token usage stays low because Claude loads files intelligently:

  • hot.md (~500 tokens of recent context)
  • index.md (one-line summaries)
  • Only the specific relevant pages for the current query

You never load the entire vault.

What It Looks Like After a Few Weeks

Open Obsidian’s graph view and you’ll see a rich, color-coded map of your knowledge:

  • Concepts cluster naturally
  • Sources link to entities and ideas
  • Contradictions are explicitly flagged
  • The “second brain” graph Obsidian always promised becomes real and useful

Every new source strengthens the entire network instead of creating isolated notes.

Key Benefits

  • Persistent memory — Claude remembers your projects and knowledge across sessions.
  • Automatic maintenance — No manual linking, tagging, or organizing.
  • Compound knowledge — New information builds on everything that came before.
  • Visual thinking — Easy canvas generation for complex topics.
  • Low maintenance — The system does the heavy lifting.

This setup follows the spirit of Andrej Karpathy’s “LLM Wiki” idea but makes it practical and automatic inside Obsidian + Claude Code.

Start simple: create the vault, install the plugin, run /wiki, then try ingesting one article and using /save after your next research session.

Your future self (and your AI) will thank you.

If you have more questions, please feel free to contact me at any time: https://t.me/FatherSon97

#Obsidian #ClaudeAI #ClaudeCode #SecondBrain #PKM #Productivity #AItools #KnowledgeManagement #ObsidianPlugins #AIWorkflow #PersonalKnowledgeManagement
Enter fullscreen mode Exit fullscreen mode

Top comments (0)