obsidian-second-brain
Persistent memory for Claude Code, Codex and 6 other AI agents, stored as plain markdown in your Obsidian vault. New: Crew, one shared logbook so Claude Code, C
What is obsidian-second-brain?
Persistent memory for Claude Code, Codex and 6 other AI agents, stored as plain markdown in your Obsidian vault. New: Crew, one shared logbook so Claude Code, Codex, Cursor and Grok Bot know what each other did. 48 commands: semantic search, self-rewriting notes, key-less research, scheduled agents.
Overview of obsidian-second-brain
What it is
obsidian-second-brain is a plugin that provides persistent memory for Claude Code and six other CLI agents, storing information as plain markdown files in an Obsidian vault. It is an evolution of Karpathy's LLM Wiki pattern, where the vault rewrites itself instead of just appending new pages. It uses OKM (Open Knowledge Metabolism), which categorizes facts as timeless, dated, or pointers to prevent outdated information from accumulating. The plugin offers 45 commands, including hybrid semantic search, self-rewriting notes, key-less web research, and scheduled agents that maintain the vault automatically.
Key features
- Self-rewriting notes: new sources update existing pages rather than appending, and contradictions are reconciled automatically via
/obsidian-reconcile. - 4 scheduled agents: morning brief, nightly consolidation, weekly review, and vault-health check run without manual prompting.
- Live research from X (via Grok), the web (via Perplexity Sonar Pro), and YouTube (via transcript API and optional vision analysis).
- AI-first note format with frontmatter and a preamble for LLM retrieval, not human review.
/obsidian-synthesizefinds unnamed patterns across sources and writes synthesis pages./obsidian-challengesearches the vault for past failures and reversed decisions to push back with the user's own history.- Multilingual trigger schema and a
/create-commandinterview flow for adding new commands.
Use cases
- After a meeting,
/obsidian-saveextracts decisions, people, tasks, and ideas into the correct notes. - Ingest voice memos, screenshots, or YouTube videos with
/obsidian-ingest, which transcribes, extracts structure, and rewrites existing vault pages. - Before a big decision,
/obsidian-challengeuses the vault's past failures to challenge the user. /obsidian-visualizegenerates a visual canvas of the vault, color-coded by type.- The nightly agent runs five phases: close the day, reconcile contradictions, synthesize patterns, heal orphan notes, and rebuild the index.
/obsidian-dailypulls calendar events, overdue tasks, and overnight changes into a daily note./x-readfetches X posts with thread and replies;/x-pulsescans trending topics for content ideas./researchand/research-deepperform web research with citations, and vault-first deep research that fills only knowledge gaps.
Getting started
See the repository README for installation instructions.
License and pricing
MIT license. Open source (free).
Based on the project's public README and repository metadata.