qmd

Index and search local files using BM25, vector embeddings, and reranking.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/caiazzop/clawdbot-personal-assistant --skill qmd-caiazzop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/caiazzop/clawdbot-personal-assistant/tree/main/skills/qmd
Command: npx skills add https://github.com/caiazzop/clawdbot-personal-assistant --skill qmd-caiazzop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a powerful command-line interface for indexing and searching local files, enabling efficient retrieval of information stored on your system.

Core Features & Use Cases

  • Local Indexing: Create and manage indexes of your local files using various methods.
  • Hybrid Search: Supports BM25, vector search, and a combined hybrid approach for comprehensive results.
  • Quick Retrieval: Quickly get specific document snippets or full documents.
  • Use Case: Quickly find all markdown files related to a specific project and search within them for a particular keyword or concept.

Quick Start

Use qmd to search for 'AI assistants' within your indexed documents.

Frequently Asked Questions about qmd

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

FAQPage Schema
How do I index and search local files using the command line?

You can index and search local files using the qmd command-line interface to facilitate efficient information retrieval from local document collections. It creates indexes stored locally in the ~/.cache/qmd directory.

What is hybrid search and how does it work with local documents?

Hybrid search combines BM25 and vector search methods to comprehensively retrieve information from your local documents. This combined approach leverages both keyword matching and semantic embeddings for better results.

Do I need Ollama to perform vector search on local files?

Yes, you need Ollama to perform vector search and reranking on local files. The system leverages Ollama specifically to generate vector embeddings and rerank your indexed document snippets.

What is the best way to retrieve specific snippets from indexed markdown files?

The best way to retrieve specific snippets is by using the quick retrieval features of the qmd CLI. It allows you to efficiently search within your indexed local files for specific keywords or concepts.

Can I use BM25 for local file indexing without vector embeddings?

Yes, you can use BM25 for local file indexing independently of vector embeddings. The system supports BM25, vector search, and a combined hybrid approach, giving you flexibility in retrieval methods.

Where are local search indexes stored on my system?

Local search indexes are stored on your system in the ~/.cache/qmd directory. This allows the command-line interface to quickly access and manage your indexed document collections.