qmd

Index and query local markdown notes with hybrid BM25 and vector search.

14|2|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/gquthier/CLAWG --skill qmd-gquthier
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/gquthier/CLAWG/tree/main/optional-skills/research/qmd
Command: npx skills add https://github.com/gquthier/CLAWG --skill qmd-gquthier

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Indexes and queries personal markdown notes, transcripts, and documents locally with a hybrid search that blends keyword matching, semantic understanding, and LLM reranking while staying offline.

Core Features & Use Cases

  • Local, on-device indexing of notes and documents for privacy-preserving search.
  • Hybrid search combining BM25 keyword retrieval, vector semantics, and optional LLM reranking for higher quality results.
  • MCP integration to expose search capabilities to CLAWG workflows and other tools.

Quick Start

Run qmd to start querying your indexed collections and retrieve relevant results.

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 markdown notes offline?

Index markdown notes locally and query them offline using qmd, which keeps all retrieval and reranking processes private without sending data to external servers.

What is hybrid search for personal knowledge bases?

Hybrid search combines BM25 keyword retrieval, vector semantic search, and optional LLM reranking to deliver highly relevant results from indexed notes and transcripts.

How do I run semantic search across meeting transcripts locally?

Index transcript collections with qmd to run semantic search locally, using its vector search capabilities to retrieve relevant content on-device without external API calls.

Do I need Node.js 22+ to use local vector search for notes?

Yes, Node.js 22+ is required to run qmd, along with locally cached models, to perform on-device vector search and document indexing.

Can I expose local note search to other tools via MCP?

qmd provides MCP integration to expose local search capabilities to CLAWG workflows and other tools, allowing external applications to query your indexed markdown collections.

What is the best way to do private keyword lookups on personal documentation?

Use qmd's on-device BM25 retrieval to perform private keyword lookups, which indexes personal documentation locally and keeps all search queries offline.