qmd

Index Markdown and text files for local hybrid search with BM25, vectors, and reranking.

Updated May 3, 2026
One-click install
npx skills add https://github.com/JuanMS20/solviora-agent --skill qmd-juanms20
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/JuanMS20/solviora-agent/tree/main/optional-skills/research/qmd
Command: npx skills add https://github.com/JuanMS20/solviora-agent --skill qmd-juanms20

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Local, on-device search enables fast, private retrieval across notes, transcripts, and documents without relying on cloud services.

Core Features & Use Cases

  • Local indexing of Markdown notes, meeting transcripts, and documentation for offline search
  • Hybrid retrieval combining BM25, vector search, and LLM reranking for high-quality results
  • MCP integration support to expose search tools to Hermes Agent while maintaining a locally-driven workflow

Quick Start

Install qmd globally, add a collection with qmd collection add <path> --name <name>, then run qmd to start indexing and searching.

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I search Markdown notes and transcripts locally without cloud services?

qmd enables local, on-device search across Markdown notes and transcripts by indexing file collections and running BM25, vector, and LLM reranking retrieval without cloud dependencies. It requires Node.js 22 or newer and local SQLite with extension support on macOS.

What is hybrid retrieval and how does it work for local document search?

Hybrid retrieval for local document search combines BM25 keyword matching, vector-based semantic search, and LLM reranking to deliver high-quality results from indexed Markdown and text files. This multi-layer approach captures both exact terms and contextual meaning without cloud dependencies.

Do I need Node.js and SQLite to run on-device note search?

Yes, on-device note search requires Node.js 22 or newer and local SQLite with extension support on macOS. These dependencies enable the local embedding, indexing, and hybrid retrieval pipeline for your Markdown and text file collections.

Can I use local search with an AI agent while keeping data offline?

Yes, qmd supports MCP integration to expose search tools to Hermes Agent while maintaining a locally-driven workflow. This allows AI agents to query your indexed Markdown notes and transcripts without sending data to cloud services.

How do I index a collection of text files for offline search?

Install qmd globally, add a collection using the command qmd collection add <path> --name <name>, then run qmd to start indexing and searching. This prepares your local Markdown and text files for hybrid retrieval queries.

What are the limitations of local note search on macOS?

Local note search on macOS requires local SQLite with extension support and Node.js 22 or newer. Without these specific environment configurations, the qmd CLI cannot manage collections, generate embeddings, or perform hybrid retrieval.