qmd

Index local markdown collections for hybrid BM25 and vector search.

1|Updated May 16, 2026
One-click install
npx skills add https://github.com/devMoez/titan --skill qmd-devmoez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/devMoez/titan/tree/main/optional-skills/research/qmd
Command: npx skills add https://github.com/devMoez/titan --skill qmd-devmoez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

QMD eliminates the frustration of hunting through scattered notes, meeting transcripts, and docs by giving you fast, accurate local search across large markdown/text collections.

Core Features & Use Cases

  • Hybrid retrieval (BM25 + vector + LLM reranking): combine keyword matching, semantic understanding, and higher-quality ranking for difficult queries.
  • Local, on-device knowledge base search: index and query your own text files without relying on cloud services.
  • MCP and CLI access: use it directly in the terminal or expose tools to Titan Agent through MCP for seamless agent workflows.

Quick Start

Run: qmd collection add ~/notes --name notes, then run: qmd embed, and finally search with: qmd query "what did we decide about the database migration" .

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I search my local notes and markdown files without cloud services?

You can search local notes on-device by indexing your text and markdown files with a local knowledge base tool. This eliminates manual scanning and reliance on cloud services by enabling fast, accurate retrieval directly from your machine.

What is hybrid RAG retrieval and when do I need it for my knowledge base?

Hybrid RAG retrieval combines BM25 keyword matching, vector semantic search, and LLM-based reranking to find relevant notes. You need it for difficult queries where pure keyword or semantic search alone fails to locate relevant documents accurately.

How do I set up local vector search and BM25 indexing for my documents?

To set up local vector search and BM25 indexing, add your text directory to a collection, generate embeddings, and execute queries. This indexes your markdown and text files locally for fast, accurate retrieval.

Can I expose local document search tools to MCP-driven agent workflows?

Yes, you can expose local document search tools to MCP-driven agent workflows. This allows agents to query and retrieve documents from indexed collections directly through the Model Context Protocol for seamless automation.

Does local RAG search work with the command line interface?

Yes, local RAG search works directly in the command line interface. You can manage collections, generate embeddings, and execute hybrid queries across your indexed text files entirely through CLI commands.

What are the limitations of LLM-based reranking for local search?

LLM-based reranking requires generating embeddings and local indexing with BM25 and vector search. The limitation is the processing overhead for higher-quality ranking, which demands local compute resources for difficult queries.