8.0k★by dpaluy
qmd – OpenClaw Skill
qmd is an OpenClaw Skills integration for writing workflows. 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, documentation, meeting transcripts, and any markdown-based knowledge. Requires qmd CLI installed (bun install -g https://github.com/tobi/qmd).
Skill Snapshot
| name | qmd |
| description | 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, documentation, meeting transcripts, and any markdown-based knowledge. Requires qmd CLI installed (bun install -g https://github.com/tobi/qmd). OpenClaw Skills integration. |
| owner | dpaluy |
| repository | dpaluy/qmd-cli |
| language | Markdown |
| license | MIT |
| topics | |
| security | L1 |
| install | openclaw add @dpaluy/qmd-cli |
| last updated | Feb 7, 2026 |
Maintainer
name: qmd description: 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, documentation, meeting transcripts, and any markdown-based knowledge. Requires qmd CLI installed (bun install -g https://github.com/tobi/qmd).
QMD - Local Markdown Search
Search and retrieve documents from locally indexed markdown knowledge bases.
Installation
bun install -g https://github.com/tobi/qmd
Setup
# Add a collection
qmd collection add ~/notes --name notes --mask "**/*.md"
# Generate embeddings (required for vsearch/query)
qmd embed
Usage Rules
Always use --json flag for structured output when invoking qmd commands.
Search Commands
search (BM25 keyword search - fast)
qmd search "authentication flow" --json
qmd search "error handling" --json -n 10
qmd search "config" --json -c notes
vsearch (vector semantic search)
qmd vsearch "how does login work" --json
qmd vsearch "authentication best practices" --json -n 20
query (hybrid with LLM re-ranking - best quality)
qmd query "implementing user auth" --json
qmd query "deployment process" --json --min-score 0.5
Search Options
| Option | Description |
|---|---|
-n NUM | Number of results (default: 5, or 20 with --json) |
-c, --collection NAME | Restrict to specific collection |
--min-score NUM | Minimum score threshold |
--full | Return complete document content in results |
--all | Return all matches |
Retrieval Commands
get (single document)
qmd get docs/guide.md --json
qmd get "#a1b2c3" --json
qmd get notes/meeting.md:50 -l 100 --json
multi-get (multiple documents)
qmd multi-get "docs/*.md" --json
qmd multi-get "api.md, guide.md, #abc123" --json
qmd multi-get "notes/**/*.md" --json --max-bytes 20480
Maintenance Commands
qmd update # Re-index changed files
qmd status # Check index health
qmd collection list # List all collections
Search Mode Selection
| 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: vsearch and query have ~1 minute cold start latency for vector initialization. Prefer search for interactive use.
MCP Server
qmd can run as an MCP server for direct integration:
qmd mcp
Exposes tools: qmd_search, qmd_vsearch, qmd_query, qmd_get, qmd_multi_get, qmd_status
No README available.
Permissions & Security
Security level L1: Low-risk skills with minimal permissions. Review inputs and outputs before running in production.
Requirements
- OpenClaw CLI installed and configured.
- Language: Markdown
- License: MIT
- Topics:
FAQ
How do I install qmd?
Run openclaw add @dpaluy/qmd-cli in your terminal. This installs qmd into your OpenClaw Skills catalog.
Does this skill run locally or in the cloud?
OpenClaw Skills execute locally by default. Review the SKILL.md and permissions before running any skill.
Where can I verify the source code?
The source repository is available at https://github.com/openclaw/skills/tree/main/skills/dpaluy/qmd-cli. Review commits and README documentation before installing.