Repolode
Submit
breferrari

breferrari/obsidian-mind

An Obsidian vault template that gives AI coding agents like Claude Code persistent memory across sessions.

View on GitHub
Stars
5,503
Forks
611
Open issues
16
Last commit
20 days ago

What is it?

Obsidian Mind is a pre-structured Obsidian vault that AI coding agents read and write as long-term memory. Each session starts with context from the user's goals, active projects, open tasks and recent git changes, so the agent does not begin from a blank slate. Notes are filed into folders by purpose and linked to related people, decisions and projects.

The project is built mainly for Claude Code, with hook and command configurations for Codex CLI and Gemini CLI that use the same scripts and vault. Lifecycle hooks classify messages such as decisions, incidents and 1:1 meetings, validate frontmatter and wikilinks on markdown writes, and back up session transcripts before context compaction. Slash commands cover daily standup, brain dumps, end-of-day wrap-up, weekly synthesis and review preparation.

Optional QMD integration adds local semantic search over the vault, exposed to agents through an MCP server, and the same server can be registered so that sessions in other repositories can query the vault.

Key features

  • 01Loads North Star goals, active projects, open tasks and recent git changes at session start.
  • 02Classifies messages into decisions, incidents, wins and meetings, and files them into linked notes.
  • 03Validates frontmatter and wikilinks whenever markdown notes are written.
  • 04Backs up session transcripts before context compaction.
  • 05Provides slash commands for standup, wrap-up, weekly synthesis and review briefs.
  • 06Offers optional local semantic search through QMD and an MCP server.

Use cases

  • Keeping an AI coding agent aware of ongoing projects and past decisions across days or weeks.
  • Logging 1:1 meetings, incidents and accomplishments as linked notes for performance reviews.
  • Using Obsidian as a personal knowledge base that coding agents can query and update.

Quick start

  1. 1

    Install ShardMind globally

    npm install -g shardmind
  2. 2

    Create an empty folder for the vault and enter it

    mkdir my-vault && cd my-vault
  3. 3

    Install the vault template with ShardMind

    shardmind install github:breferrari/obsidian-mind
  4. 4

    Open the folder in Obsidian as a vault, then run your agent (for example Claude Code) in that directory

    claude

Things to know

  • Full support is for Claude Code only; Codex CLI and Gemini CLI get hooks and commands but fewer features.
  • Obsidian 1.12+ is required for the Obsidian CLI integration.
  • Optional QMD semantic search downloads about 2.3 GB of local models on first use.

In collections

Long-term memory for AI agentsClaude Code tools, skills & pluginsOpen-source AI agent frameworks & apps

Topics

#ai-agents#obsidian#persistent-memory#knowledge-management#claude-code#developer-productivity#codex-cli#gemini-cli#obsidian-vault#second-brain

FAQ

What is obsidian-mind?
An Obsidian vault template that gives AI coding agents like Claude Code persistent memory across sessions. Obsidian Mind is a pre-structured Obsidian vault that AI coding agents read and write as long-term memory. Each session starts with context from the user's goals, active projects, open tasks and recent git changes, so the agent does not begin from a blank slate. Notes are filed into folders by purpose and linked to related people, decisions and projects.
Is obsidian-mind free to use? What license does it have?
obsidian-mind is open source under the MIT license. Check the license terms before using it in commercial products.
Is obsidian-mind still maintained?
Actively maintained. The last commit to obsidian-mind was on Oct 17, 2026.
What can I use obsidian-mind for?
Keeping an AI coding agent aware of ongoing projects and past decisions across days or weeks. Logging 1:1 meetings, incidents and accomplishments as linked notes for performance reviews. Using Obsidian as a personal knowledge base that coding agents can query and update.
How do I install obsidian-mind?
Install ShardMind globally: npm install -g shardmind Create an empty folder for the vault and enter it: mkdir my-vault && cd my-vault Install the vault template with ShardMind: shardmind install github:breferrari/obsidian-mind Open the folder in Obsidian as a vault, then run your agent (for example Claude Code) in that directory: claude
Where can I get obsidian-mind?
The source code and installation instructions are on GitHub: https://github.com/breferrari/obsidian-mind

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects