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, and wrap up for 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, and mcp__qmd__multi_get tools.
  • ShardMind package manager: install via shardmind install or git 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/breferrariobsidian-mind.svg)](https://yunodb.com/tools/breferrariobsidian-mind?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/breferrariobsidian-mind?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/breferrariobsidian-mind.svg" alt="Featured on YunoDB" height="20"></a>