qmd

Search local markdown notes and documents with hybrid keyword, vector, and reranked retrieval.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/moistalgia/hermes-tools --skill qmd-moistalgia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/moistalgia/hermes-tools/tree/main/skills-from-hermes/qmd
Command: npx skills add https://github.com/moistalgia/hermes-tools --skill qmd-moistalgia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @tobilu/qmd.

What problem does it solve? Finding information across large collections of markdown notes, meeting transcripts, and documentation is slow with plain grep and inaccurate with naive keyword search. This Skill sets up and operates qmd, a fully local search engine that combines BM25 keyword matching, semantic vector search, and LLM reranking without any cloud dependency. ## Core Features & Use Cases - Three Search Modes: Run instant BM25 keyword search, semantic vector search, or full hybrid search with query expansion and reranking depending on speed and quality needs. - Collection Management: Add directories as named collections, attach context descriptions to improve retrieval, and generate embeddings with a single command. - MCP Integration: Expose search tools to an agent via stdio or a persistent HTTP daemon that keeps models warm for fast repeated queries. - Use Case: A user asks "what decisions were made about the database migration" across months of meeting transcripts; the hybrid query mode expands the question, retrieves candidates in parallel, and reranks them to surface the right note. ## Quick Start Ask the agent to search your indexed notes for a topic, for example: "Search my notes for everything about the API redesign decisions."

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I search my markdown notes locally without cloud services?▼

Install qmd via npm, add your notes directory with qmd collection add, run qmd embed to build vectors, then query with qmd search, qmd vsearch, or qmd query. All models run locally with no cloud dependency.

What is the difference between qmd search, vsearch, and query?▼

qmd search is BM25 keyword-only and near-instant with no models loaded. qmd vsearch uses the embedding model for semantic matching. qmd query runs the full hybrid pipeline with query expansion, parallel retrieval, and LLM reranking for best quality.

Why is my first qmd query slow?▼

The first query cold-loads roughly 2GB of GGUF models, taking around 19 seconds. Run qmd mcp --http --daemon to keep models warm in memory, or use qmd search for BM25-only queries that need no models.

Does qmd work on macOS with system SQLite?▼

macOS system SQLite lacks extension loading, which qmd requires. Install SQLite via Homebrew with brew install sqlite and ensure it appears on PATH before the system version.

How do I improve qmd search result quality?▼

Add context descriptions to each collection with qmd context add so the engine understands what the documents contain, and re-run qmd embed after adding new files. Use hybrid qmd query mode for conceptual questions.