# Qmd

> Local search/indexing CLI (BM25 + vectors + rerank) with MCP mode.

- Skill: `hanzoskill/qmd` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add hanzoskill/qmd`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hanzoskill/qmd/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: hanzoskill (https://skillmd.com/u/hanzoskill)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hanzoskill/qmd

---


# qmd

Use `qmd` to index local files and search them.

Indexing
- Add collection: `qmd collection add /path --name docs --mask "**/*.md"`
- Update index: `qmd update`
- Status: `qmd status`

Search
- BM25: `qmd search "query"`
- Vector: `qmd vsearch "query"`
- Hybrid: `qmd query "query"`
- Get doc: `qmd get docs/path.md:10 -l 40`

Notes
- Embeddings/rerank use Ollama at `OLLAMA_URL` (default `http://localhost:11434`).
- Index lives under `~/.cache/qmd` by default.
- MCP mode: `qmd mcp`.