# obsidian-second-brain

> A Claude Code skill that turns your Obsidian vault into a living second brain — autonomous writes, thinking tools, knowledge ingestion, scheduled agents, and _CLAUDE.md for cross-surface context.

- **URL**: https://www.freshcrate.ai/projects/obsidian-second-brain
- **Author**: eugeniughelbur
- **Category**: RAG & Memory
- **Latest version**: `v0.10.0` (2026-05-31)
- **License**: MIT
- **Source**: https://github.com/eugeniughelbur/obsidian-second-brain
- **Language**: Python
- **GitHub**: 244 stars, 30 forks
- **Registry**: github
- **Tags**: `ai-agents`, `claude-code`, `obsidian`, `obsidian-plugin`, `productivity`, `python`, `second-brain`

## Description

A Claude Code skill that turns your Obsidian vault into a living second brain — autonomous writes, thinking tools, knowledge ingestion, scheduled agents, and _CLAUDE.md for cross-surface context.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.10.0` | 2026-05-31 | High | Your code projects, documented in the same brain as your ideas and decisions.  ## Headline: `/obsidian-architect`  Point it at a software project and it writes a maintained set of architecture notes into your vault - an overview (with a Mermaid diagram and inferred personas), one note per core module, and a key-decisions note. Re-run it to refresh: **sentinel markers** (`<!-- @generated -->` / `<!-- @user -->`) mean a refresh updates only the generated content and never clobbers your hand-edits. |
| `v0.8.0` | 2026-05-15 | High | ## Headline  `/notebooklm` rewritten end to end. The old version required opening notebooklm.google.com, pasting in a bundle, asking the question, copying the response back into the terminal. The new version is a single command, single HTTP call, no browser. Same architectural shape as `/research-deep`.  Under the hood it uploads the top 12 relevant vault notes to a Gemini File Search store, asks Gemini for a citation-style synthesis grounded only against those sources, writes the AI-first synth |
| `v0.6.0` | 2026-04-26 | High | ## 🧠 v0.6.0 — Phase 2: AI-First Rule Wired Everywhere  The follow-up to [v0.5.0](https://github.com/eugeniughelbur/obsidian-second-brain/releases/tag/v0.5.0). All 26 existing commands now explicitly enforce the AI-first vault rule — the same rule the 5 research commands have followed since day one.  > **Why this matters:** the AI-first rule was established in v0.5 (`_CLAUDE.md` Section 0), but the existing commands relied on Claude inferring it from the operating manual. v0.6 wires it explicitl |
| `v4.0.0` | 2026-04-09 | High | ## The vault sees, hears, thinks, and heals itself.  Built from competitive research across Mem0, Zep, Letta, MemPalace, and 50+ community discussions.  ### Voice-to-Vault & Screenshot-to-Note `/obsidian-ingest` now accepts audio files and images: - **Audio** (.m4a, .mp3, .wav): transcribed with Whisper, speakers identified, decisions/tasks/promises extracted - **Screenshots** (.png, .jpg): OCR + AI context, handles UI screenshots, whiteboards, chat screenshots  Same ingest pipeline. One more in |
| `v3.2.0` | 2026-04-09 | Medium | ## The vault remembers what was true and when.  ### Temporal Facts Facts change. People switch roles. Projects change status. You move cities. Before this release, the vault overwrote old facts. Now it tracks the timeline.  ```yaml timeline:   - fact: "CTO at Acme Corp"     from: 2024-01-01     until: 2026-04-07   - fact: "Architect at Acme Corp"     from: 2026-04-07     until: present ```  Old facts aren't deleted -- they get an `until:` date. This enables: - **Historical queries**: "Who was my |
| `v3.1.0` | 2026-04-07 | High | ## The vault thinks for itself now.  ### `/obsidian-synthesize` — Auto-Synthesis The vault scans itself for patterns nobody asked about. Cross-source connections, entity convergence, concept evolution, orphan rescue. Runs manually or as a scheduled agent. The vault generates its own insight.  ### `/obsidian-export` — Agent-Readable Export Flat JSON or markdown snapshot of your entire vault. Any AI tool, agent, or automation can consume it without knowing your folder structure. The bridge between |
| `v3.0.0` | 2026-04-06 | Medium | ## The vault is alive.  This is the biggest release since v1. The vault no longer just stores knowledge — it rewrites itself with every input.  ### The Living Vault Principle Before v3, ingesting a source created new pages. Now it REWRITES existing ones. A new article about someone you already have a note on? Their entity page gets rewritten with new context — not appended to. A new source that contradicts an old claim? The old page gets updated with the current truth, and the change is document |
| `v2.2.0` | 2026-04-05 | Medium | ## What's New in v2.2  ### Enhanced `/obsidian-health` — Smarter Audits The health check now goes beyond structural issues. Three new parallel agents: - **Contradictions**: finds claims in Key Decisions and Knowledge/ that conflict with each other or are superseded by newer sources - **Concept gaps**: detects terms mentioned 3+ times across notes that lack a dedicated page - **Stale claims**: flags Knowledge/ notes older than 6 months on fast-moving topics (tools, APIs, pricing)  ### Progressive |
| `v2.1.0` | 2026-04-05 | Medium | ## What's New in v2.1  Inspired by [Andrey Karpathy's LLM-Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) — the vault now compounds knowledge, not just stores it.  ### Two-Output Rule Every thinking tool (`/obsidian-challenge`, `/obsidian-emerge`, `/obsidian-connect`, `/obsidian-graduate`) now automatically saves its output back into the vault. The user gets the answer AND the vault gets smarter. No more insights lost to chat history.  ### `index.md` — Vault Navi |
| `v2.0.0` | 2026-04-05 | Medium | ## What's New in v2  ### Thinking Tools (4 new commands) Your vault doesn't just store anymore — it thinks with you.  - **`/obsidian-challenge`** — Red-teams your ideas against your own vault history. Finds contradictions, past failures, and flawed assumptions using your own words. - **`/obsidian-emerge`** — Scans your last 30 days of notes and surfaces unnamed patterns — recurring themes and conclusions you haven't explicitly connected. - **`/obsidian-connect [A] [B]`** — Bridges two unrelated |

## Citation

- HTML: https://www.freshcrate.ai/projects/obsidian-second-brain
- Markdown: https://www.freshcrate.ai/projects/obsidian-second-brain.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/obsidian-second-brain/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._