obsidian-mind
A self-organizing Obsidian vault that gives AI coding agents persistent memory.
What is obsidian-mind?
A self-organizing Obsidian vault that gives AI coding agents persistent memory.
Overview of obsidian-mind
What it is
Obsidian Mind is an Obsidian vault template designed to give AI coding agents persistent memory. It is built for Claude Code, with hooks for Codex CLI and Gemini CLI. The vault organizes notes, links, indexes, and performance tracking so that each conversation builds on the last.
Key features
- Persistent memory: agents read North Star goals, check active projects, and scan recent memories at session start.
- Slash commands:
/om-standup,/om-dump,/om-incident-capture, andwrap upfor structured interactions. - Multi-agent support: works with Claude Code (full support), Codex CLI, and Gemini CLI using the same hooks and commands.
- Optional QMD semantic search: local models (embeddinggemma-300M, qmd-query-expansion-1.7B, Qwen3-Reranker-0.6B) provide semantic recall without API keys or per-query cost.
- MCP server integration: QMD registers as a Model Context Protocol server, exposing
mcp__qmd__query,mcp__qmd__get, andmcp__qmd__multi_gettools. - ShardMind package manager: install via
shardmind installorgit clone; ShardMind is additive and not load-bearing.
Use cases
- Morning kickoff: load North Star, active projects, open tasks, and recent git changes.
- Brain dump after meetings: capture key takeaways, decisions, and wins into structured notes.
- Incident response: capture Slack incident threads, create people notes, and build timelines.
- End-of-day wrap-up: verify links, update indexes, and suggest improvements.
Getting started
bashnpm install -g shardmindmkdir my-vault && cd my-vaultshardmind install github:breferrari/obsidian-mindOr clone directly:bashgit clone https://github.com/breferrari/obsidian-mind.gitThen open the folder as an Obsidian vault, enable Obsidian CLI (Obsidian 1.12+), and run your agent in the vault directory.
License and pricing
License: MIT. Pricing: open source.
Based on the project's public README and repository metadata.