Search and retrieve markdown documents from local knowledge bases using qmd. Supports BM25 keyword search, vector semantic search, and hybrid search with LLM re-ranking. Use for querying indexed notes
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Search and retrieve documents from locally indexed markdown knowledge bases.
bun install -g https://github.com/tobi/qmd
# Add a collection qmd collection add ~/notes --name notes --mask "**/*.md"Generate embeddings (required for vsearch/query)
qmd embed
Always use
flag for structured output when invoking qmd commands.--json
qmd search "authentication flow" --json qmd search "error handling" --json -n 10 qmd search "config" --json -c notes
qmd vsearch "how does login work" --json qmd vsearch "authentication best practices" --json -n 20
qmd query "implementing user auth" --json qmd query "deployment process" --json --min-score 0.5
| Option | Description |
|---|---|
| Number of results (default: 5, or 20 with --json) |
| Restrict to specific collection |
| Minimum score threshold |
| Return complete document content in results |
| Return all matches |
qmd get docs/guide.md --json qmd get "#a1b2c3" --json qmd get notes/meeting.md:50 -l 100 --json
qmd multi-get "docs/*.md" --json qmd multi-get "api.md, guide.md, #abc123" --json qmd multi-get "notes/**/*.md" --json --max-bytes 20480
qmd update # Re-index changed files qmd status # Check index health qmd collection list # List all collections
| Mode | Speed | Quality | Best For |
|---|---|---|---|
| search | Fast | Good | Exact keywords, known terms |
| vsearch | Medium | Better | Conceptual queries, synonyms |
| query | Slow | Best | Complex questions, uncertain terms |
Performance note:
vsearchquerysearchqmd can run as an MCP server for direct integration:
qmd mcp
Exposes tools:
qmd_searchqmd_vsearchqmd_queryqmd_getqmd_multi_getqmd_statusNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.