QMD

QMD is a local search engine over your Markdown vault. It combines semantic retrieval with keyword (BM25) ranking, so a query finds the relevant note whether you remember the exact words or just the idea.

Why braynee uses it

"Feed the right slice of context" is, mechanically, a QMD query. When Claude Code needs a past decision or a related note, /braynee:recall and the knowledge agents search the vault instead of guessing. QMD is what makes a PARA vault addressable — without it the second brain is a pile of files no one can reach at the right moment.

How it's set up

There is nothing to install. QMD ships inside the braynee plugin as a bundled qmd-wrapper. Setup verifies it responds and builds the initial index over your vault; hooks keep that index fresh as the vault changes.

QMD is the only tool braynee bundles, and the reason is narrow: it's a Node script, and a Claude Code plugin is a folder of files that can carry a script as long as the runtime it needs is already present. The other tools can't ride along — git, Node, and Python are system binaries braynee must not shadow; beads is a standalone binary with its own shared server; Obsidian is a closed app whose plugins must live in your vault. Bundling fits a script on an existing runtime. Only QMD qualifies.

Connects with

• Tools: indexes the Obsidian vault · keeps no state of its own
• Concepts: powers context retrieval in Architecture — Pillar 2 · serves PARA slices
• Reference: /braynee:recall and /braynee:query · knowledge agents · hooks that re-index