breferrari

obsidian-mind

AI#Obsidian#Claude Code #Automation#Knowledge Management#Productivity

111

// summary

Obsidian Mind is an Obsidian knowledge base template designed specifically for Claude Code, aiming to solve the problem of AI long-term memory loss through automated conversation hooks and structured storage. It ensures that Claude has access to the complete context at the start of every session by automatically linking work notes, decision records, meeting minutes, and performance evidence into a knowledge graph. The system supports daily workflow management through natural language interaction and can automatically generate performance evaluation briefs and project summaries.

// technical analysis

Obsidian Mind is a knowledge management architecture designed specifically for Claude Code, aiming to solve the problem of AI session context loss by transforming Obsidian vaults into long-term memory banks for Claude. The project adopts a 'Vault-first' design philosophy, utilizing lifecycle hooks and subagents to automatically handle note categorization, linking, indexing, and performance tracking, ensuring that the AI can maintain a coherent working state across sessions. Its core value lies in transforming daily conversations into a traceable knowledge graph through structured folder organization and automated metadata management, thereby significantly improving developer efficiency in project management, performance evaluation, and incident response.

// key highlights

Automatically loads North Star goals, active projects, and to-do items via the SessionStart hook, ensuring Claude has full context every time it starts.

Built-in multiple lifecycle hooks to achieve a fully automated workflow from user input classification to note verification and index updates.

Provides a dedicated performance tracking system that automatically generates the chain of evidence required for performance evaluations by linking capability notes with work records.

Includes 15 specialized commands (such as /standup, /dump, and /review-brief) to support various scenarios ranging from daily task management to in-depth reviews.

Supports seamless migration of existing Obsidian vaults to this architecture via the /vault-upgrade command, with automatic semantic classification and refactoring.

Utilizes subagents (such as brag-spotter and slack-archaeologist) to handle complex tasks, performing deep analysis without interfering with the main session.

// use cases

Daily workflow automation: Automatically load project context, task lists, and organize daily work results via /standup and /wrap-up commands.

Performance and career development tracking: Utilize dedicated performance folders and sub-agents to automatically collect work evidence, manage competency assessments, and generate performance review briefs.

Intelligent knowledge management and retrieval: Achieve automatic association and maintenance of decision records, meeting minutes, and project documentation across sessions through automated classification hooks and optional QMD semantic search.

// getting started

First, clone this repository locally and open it as an Obsidian vault, ensuring that Claude Code and Obsidian 1.12+ are installed. Run the claude command in the root directory of the repository to start a session, and configure your core goals in brain/North Star.md. Subsequently, you can communicate with Claude using natural language and utilize commands like /standup or /dump to begin recording your workflow.