setup-qmd.md

qmd Setup

Install qmd

Install Bun first, then install qmd from GitHub:

bun install -g github:tobi/qmd

Verify:

qmd --help

If qmd is not on PATH, check:

~/.bun/bin/qmd --help

Create a Collection

From the target workspace root:

qmd collection add memory --name daily-logs --mask "**/*.md"

Build Embeddings

qmd update
qmd embed

Query

Hybrid search:

qmd query "关键词"

Vector search:

qmd vsearch "关键词"

MCP Integration

If the host supports MCP config, add:

{
  "mcpServers": {
    "qmd": {
      "command": "/Users/your-user/.bun/bin/qmd",
      "args": ["mcp"]
    }
  }
}

Replace the path with the real local qmd binary path.

macOS Scheduling

For local macOS instances, prefer launchd over cron for recurring qmd refresh.

Typical refresh command:

bash scripts/qmd_refresh.sh

Typical schedule:

• 11:30
• 23:30

Keep success silent and log only to a local file.