qmd

Search local markdown notes and transcripts using hybrid keyword, vector, and reranking pipelines.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill qmd-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/research/qmd
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill qmd-vivekgoquest

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 - Hybrid Local Search: Combines BM25 keyword matching, semantic vector search, and LLM reranking using three local GGUF models with no cloud dependencies. - Collection Management: Add directories as named collections, attach context descriptions to improve retrieval, and generate embeddings with qmd embed. - MCP Integration: Expose search tools directly to the agent via an MCP server in stdio mode or as a persistent HTTP daemon that keeps models warm. - Use Case: A user with years of markdown journal entries and meeting transcripts asks "what decisions were made about the database migration" and gets reranked, context-aware results from the hybrid query pipeline. ## Quick Start Install qmd with npm, add my notes folder as a collection, run the embedding step, and then search my notes 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 generate vector embeddings, then query with qmd search for keywords or qmd query for hybrid semantic search. All models run locally with no cloud dependencies.

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

qmd search runs BM25 keyword matching only and returns in about 0.2 seconds with no models loaded. qmd vsearch adds semantic vector search using the embedding model, while qmd query runs the full hybrid pipeline with query expansion and LLM reranking for the highest quality results.

Does qmd work on macOS and Linux?▼

Yes, qmd supports macOS and Linux but requires Node.js version 22 or later. On macOS you must also install SQLite via Homebrew because the system SQLite lacks extension loading support.

Why is the first qmd query slow?▼

The first query triggers a cold start of roughly 19 seconds while the three GGUF models load into memory. Run qmd mcp --http --daemon to keep models warm, or use qmd search for instant BM25-only lookups that need no models.

How do I integrate qmd with an AI agent via MCP?▼

Add an mcp_servers entry pointing to the qmd mcp command in stdio mode, or start qmd mcp --http --daemon and configure the agent with the local HTTP URL. This registers tools like mcp_qmd_search and mcp_qmd_deep_search automatically.