qmd-skill-3Local 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 Lelo78/qmd-skill-3Install 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 their collection of academic papers in Markdown format. They quickly search for related studies using keyword matches to find foundational works and employ semantic search to discover papers with similar concepts but different terminology, streamlining literature review.
A software development team indexes their internal Markdown documentation with qmd. Developers search for troubleshooting guides or API references using fast keyword searches, while semantic search helps find related documentation when exact terms are unknown, improving onboarding and issue resolution.
A law firm converts case notes and legal briefs to Markdown and indexes them with qmd. Attorneys use keyword search to retrieve specific case files by client name or date, and semantic search to find precedents with similar legal arguments, enhancing case preparation efficiency.
A medical practice indexes patient notes stored as Markdown files. Healthcare providers search for patient histories using keywords like symptoms or dates, and use semantic search to identify patterns or related cases for research, aiding in diagnosis and treatment planning.
A content creator indexes their Markdown notes on topics, ideas, and drafts. They use keyword search to quickly find specific content pieces for editing, and semantic search to discover related ideas for new projects, boosting creativity and content production speed.
Offer a free tier for individual users with basic search features and limited collections. Charge teams for advanced features like collaborative indexing, priority support, and integration with cloud storage, generating revenue through monthly subscriptions.
Sell licenses to large organizations for on-premises deployment with enhanced security, custom indexing options, and dedicated support. Include training and maintenance services, targeting industries like legal or healthcare with strict data privacy needs.
Provide consulting services to help businesses set up and optimize qmd for their specific workflows, such as integrating with existing document management systems or developing custom plugins. Offer ongoing support and training packages.
💬 Integration Tip
Integrate qmd into existing workflows by automating indexing with cron jobs and using the --json output for easy parsing by other tools or agents.
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.