qmd

Configure qmd search indexes and manage embeddings for vault searching.

23|2|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/onebrain-ai/onebrain --skill qmd-onebrain-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/onebrain-ai/onebrain/tree/main/.claude/plugins/onebrain/skills/qmd
Command: npx skills add https://github.com/onebrain-ai/onebrain --skill qmd-onebrain-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

qmd solves the problem of slow vault-wide searching by building and maintaining a local search index that supports fast keyword lookup and optional semantic retrieval.

Core Features & Use Cases

  • Index setup & lifecycle management: Configure qmd per vault, reindex when needed, and uninstall the integration without removing the qmd binary.
  • Embed generation for semantic search: Create vector embeddings so searches can match semantically rather than only by exact keywords.
  • Operational health visibility: Check index status to troubleshoot missing or misconfigured search collections.

Use case: You have a large Obsidian vault and your agent needs to reliably find notes across projects and sessions quickly; you set up qmd once, then reindex after major vault changes and optionally generate embeddings to improve relevance.

Quick Start

Ask the assistant to run: /qmd setup.

Frequently Asked Questions about qmd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I speed up Obsidian vault search across large projects?

You can achieve semantic search in Obsidian by generating vector embeddings with the qmd embed command after setting up the index. This allows searches to match notes based on semantic meaning rather than relying solely on exact keyword matches.

When should I reindex my vault search index?

You should reindex your vault search index after making major vault changes to ensure the search results reflect the latest content. Running a reindex updates the local search index, maintaining fast and accurate vault-wide search retrieval.

How do I troubleshoot missing or misconfigured vault search collections?

To troubleshoot missing or misconfigured vault search collections, use qmd to check the operational health and index status of your vault. This visibility helps identify whether the vault-specific collection in onebrain.yml requires reindexing or embedding updates.

Can I remove the qmd search integration without uninstalling the CLI tool?

Yes, you can remove the qmd search integration for a specific vault without uninstalling the underlying qmd CLI binary. The lifecycle management feature cleanly uninstalls the vault's search index configuration while leaving the tool installed for other uses.