qmd

Search local markdown notes and transcripts with hybrid keyword, vector, and reranking queries.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill qmd-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/research/qmd
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill qmd-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @tobilu/qmd.

What problem does it solve? Finding information across large collections of personal notes, meeting transcripts, and documentation is slow with plain grep and impossible to do semantically without sending data to the cloud. This Skill sets up and operates qmd, a fully local search engine that indexes text files and answers both keyword and conceptual queries on-device. ## Core Features & Use Cases - Three Search Modes: BM25 keyword search for exact terms, semantic vector search for natural-language questions, and hybrid search with LLM reranking for the highest-quality results. - Collection Management: Add directories as named collections, attach context descriptions to improve retrieval, and generate embeddings with a single command. - MCP Integration: Expose qmd as an MCP server (stdio or HTTP daemon) so the agent gets native search tools without loading the Skill each time. - Use Case: You have years of meeting transcripts and project docs. Add them as collections, run qmd embed, then ask "what decisions were made about the database migration" and get reranked, citation-ready results in seconds. ## Quick Start Install qmd with npm, add my notes folder as a collection, generate embeddings, and search for everything about the API redesign.

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 use `qmd query` for hybrid search. All models run locally with no cloud dependencies.

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

`qmd search` is BM25 keyword-only search with no models loaded, returning results in about 0.2 seconds. `qmd vsearch` uses the embedding model for semantic matching, while `qmd query` combines both with LLM reranking for the best quality.

Does qmd work as an MCP server for AI agents?▼

Yes, qmd exposes an MCP server in stdio mode (`qmd mcp`) or HTTP daemon mode (`qmd mcp --http --daemon`). It registers tools like mcp_qmd_search and mcp_qmd_deep_search that agents can call directly.

Why is the first qmd query slow at around 19 seconds?▼

The delay is cold-start latency from loading three GGUF models into memory. Run the HTTP daemon mode to keep models warm, or use BM25-only `qmd search` when semantic ranking is not needed.

What are the system requirements for running qmd?▼

qmd requires Node.js version 22 or higher and runs on macOS and Linux. macOS users also need Homebrew SQLite because the system SQLite lacks extension loading support.