qmd-skill-mainLocal hybrid search for markdown notes and docs. Use when searching notes, finding related content, or retrieving documents from indexed collections.
Install via ClawdBot CLI:
clawdbot install pmaeter/qmd-skill-mainInstall qmd via Bun:
Install qmd via BunRequires:
Local search engine for Markdown notes, docs, and knowledge bases. Index once, search fast.
qmd search (BM25). It's typically instant and should be the default.qmd vsearch only when keyword search fails and you need semantic similarity (can be very slow on a cold start).qmd query unless the user explicitly wants the highest quality hybrid results and can tolerate long runtimes/timeouts.brew install sqlite (SQLite extensions)$HOME/.bun/binInstall Bun (macOS): brew install oven-sh/bun/bun
bun install -g https://github.com/tobi/qmd
qmd collection add /path/to/notes --name notes --mask "**/*.md"
qmd context add qmd://notes "Description of this collection" # optional
qmd embed # one-time to enable vector + hybrid search*/.md).qmd search (default): fast keyword match (BM25)qmd vsearch (last resort): semantic similarity (vector). Often slow due to local LLM work before the vector lookup.qmd query (generally skip): hybrid search + LLM reranking. Often slower than vsearch and may timeout.qmd search is typically instant.qmd vsearch can be ~1 minute on some machines because query expansion may load a local model (e.g., Qwen3-1.7B) into memory per run; the vector lookup itself is usually fast.qmd query adds LLM reranking on top of vsearch, so it can be even slower and less reliable for interactive use.qmd search "query" # default
qmd vsearch "query"
qmd query "query"
qmd search "query" -c notes # Search specific collection
qmd search "query" -n 10 # More results
qmd search "query" --json # JSON output
qmd search "query" --all --files --min-score 0.3-n : number of results-c, --collection : restrict to a collection--all --min-score : return all matches above a threshold--json / --files: agent-friendly output formats--full: return full document contentqmd get "path/to/file.md" # Full document
qmd get "#docid" # By ID from search results
qmd multi-get "journals/2025-05*.md"
qmd multi-get "doc1.md, doc2.md, #abc123" --jsonqmd status # Index health
qmd update # Re-index changed files
qmd embed # Update embeddingsAutomate indexing so results stay current as you add/edit notes.
qmd search), qmd update is usually enough (fast).vsearch/query), you may also want qmd embed, but it can be slow.Example schedules (cron):
# Hourly incremental updates (keeps BM25 fresh):
0 * * * * export PATH="$HOME/.bun/bin:$PATH" && qmd update
# Optional: nightly embedding refresh (can be slow):
0 5 * * * export PATH="$HOME/.bun/bin:$PATH" && qmd embedIf your Clawdbot/agent environment supports a built-in scheduler, you can run the same commands there instead of system cron.
~/.cache/qmd/models/ (override with XDG_CACHE_HOME).qmd searches your local files (notes/docs) that you explicitly index into collections.memory_search searches agent memory (saved facts/context from prior interactions).memory_search for "what did we decide/learn before?", qmd for "what's in my notes/docs on disk?".Generated Mar 1, 2026
A researcher uses qmd to index and search through a collection of academic papers and notes in Markdown format. They rely on fast keyword search to quickly find relevant studies and occasionally use semantic search to discover papers with similar concepts when keyword matches are insufficient.
A developer indexes their project documentation and technical notes in Markdown files. They use qmd to retrieve specific documentation snippets or find related notes during development, avoiding slow searches in large codebases by focusing on structured docs.
A journalist organizes interview transcripts, research notes, and article drafts as Markdown files. They use qmd to search for key terms or related content across their collection, enabling efficient fact-checking and story development without relying on cloud services.
A medical practitioner indexes patient notes and clinical guidelines in Markdown format for privacy and speed. They use qmd to quickly retrieve patient histories or find related medical information during consultations, with keyword search as the primary method.
Offer a free version of qmd for personal use with basic search features, and a paid version for teams that includes advanced indexing, collaboration tools, and priority support. Revenue comes from subscription fees for enterprise or professional tiers.
Provide consulting services to organizations needing customized qmd setups, such as integrating with existing knowledge bases or automating indexing workflows. Revenue is generated through project-based fees and ongoing maintenance contracts.
Keep qmd open source for core functionality, while selling premium plugins for features like enhanced semantic search models, cloud sync, or advanced analytics. Revenue comes from one-time purchases or subscriptions for these add-ons.
💬 Integration Tip
Automate indexing with cron jobs or built-in schedulers to keep search results fresh, and ensure the PATH includes Bun for seamless command execution.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Create, search, and manage Bear notes via grizzly CLI.
Track water and sleep with JSON file storage
Notion API for creating and managing pages, databases, and blocks.
Smart ClawdBot documentation access with local search index, cached snippets, and on-demand fetch. Token-efficient and freshness-aware.
Work with Obsidian vaults as a knowledge base. Features: fuzzy/phonetic search across all notes, auto-folder detection for new notes, create/read/edit notes with frontmatter, manage tags and wikilinks. Use when: querying knowledge base, saving notes/documents, editing existing notes by user instructions.