obsidian-brain

Official

Use your Obsidian vault as conversational context.

Authorhamsurang
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Enable the assistant to reference a user's personal Obsidian notes as conversational context and to reliably extract and archive session learnings so insights are not lost or scattered across conversations.

Core Features & Use Cases

  • Context Loading: Parse a user query for topic keywords, scan MOCs (2-maps/) for matches, extract wikilinks, and retrieve up to five relevant notes while respecting a 15,000-character context budget.
  • Vault Resolution & Fallbacks: Resolve vault path via user override, obsidian-cli, Obsidian app config, or by asking the user, with caching and validation to avoid repeated prompts.
  • Archival Workflow: Extract learnings using progressive summarization, detect duplicates, generate editable zettel drafts from templates, save approved drafts to 0-inbox/, and update or create MOCs as needed while always requiring user approval before any write.
  • Safety Rules: Never auto-save without explicit approval, prefer Grep for MOC scanning, enforce atomic note guidelines, and present clear duplicate-resolution choices.

Quick Start

Ask the assistant to "Check my Obsidian notes for <topic> and answer using the notes you find".

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: obsidian-brain
Download link: https://github.com/hamsurang/kit/archive/main.zip#obsidian-brain

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.