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).
数据来源：ClawHub。 在 ClawSkills 查看
选择你使用的 Agent
方法一：命令行安装（推荐）
推荐（无需提前安装 clawhub）
npx clawhub@latest --dir ~/.claude/skills install qmd-cli或使用 clawhub CLI（需提前安装）
clawhub --dir ~/.claude/skills install qmd-cli⚠️ 需要 Node.js 18+，没有 Node？请使用下方方法二直接下载 ZIP。 安装 Node.js →
方法二：手动下载安装（无需 Node）
下载 ZIP，解压后将文件夹放到以下路径，重启 Agent 即可：
安装路径
~/.claude/skills/qmd-cli/💡解压后将文件夹放到上方路径，重启 Agent 即可生效
--- 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). ---
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 embedAlways use --json flag for structured output when invoking qmd commands.
qmd search "authentication flow" --json
qmd search "error handling" --json -n 10
qmd search "config" --json -c notesqmd vsearch "how does login work" --json
qmd vsearch "authentication best practices" --json -n 20qmd query "implementing user auth" --json
qmd query "deployment process" --json --min-score 0.5| 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 |
qmd get docs/guide.md --json
qmd get "#a1b2c3" --json
qmd get notes/meeting.md:50 -l 100 --jsonqmd multi-get "docs/*.md" --json
qmd multi-get "api.md, guide.md, #abc123" --json
qmd multi-get "notes/**/*.md" --json --max-bytes 20480qmd 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: vsearch and query have ~1 minute cold start latency for vector initialization. Prefer search for interactive use.
qmd can run as an MCP server for direct integration:
qmd mcpExposes tools: qmd_search, qmd_vsearch, qmd_query, qmd_get, qmd_multi_get, qmd_status
安装 QMD CLI 后，可以对 AI 说这些话来触发它
Help me get started with QMD CLI
Explains what QMD CLI does, walks through the setup, and runs a quick demo based on your current project
Use QMD CLI to search and retrieve markdown documents from local knowledge bases u...
Invokes QMD CLI with the right parameters and returns the result directly in the conversation
What can I do with QMD CLI in my documents & notes workflow?
Lists the top use cases for QMD CLI, with example commands for each scenario
将技能文件夹放到 ~/.claude/skills/qmd-cli/ 目录（个人级，所有项目可用），或 .claude/skills/qmd-cli/（项目级）。重启 AI 客户端后，用 /qmd-cli 主动调用，或让 AI 根据上下文自动发现并使用。
QMD CLI 支持 Claude、Cursor、OpenClaw，可与这些 AI 平台无缝集成，扩展其能力。
QMD CLI 可免费安装使用。请查阅仓库了解许可证信息。
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 CLI 属于「Documents & Notes」分类，该分类的技能帮助 AI 智能体在此领域执行专业任务。
Automate my documents & notes tasks using QMD CLI
Identifies repetitive steps in your workflow and sets up QMD CLI to handle them automatically