qmd-skill-2Local 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 lifecoacher/qmd-skill-2Install 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
Researchers can index their literature notes and drafts in Markdown format, enabling quick keyword searches to find relevant papers or concepts during writing. This reduces time spent manually browsing folders and ensures all notes are searchable across projects.
Development teams can use qmd to index internal Markdown documentation, allowing instant retrieval of API guides or troubleshooting steps. It supports fast BM25 searches for common queries, improving onboarding and reducing support overhead.
Writers and bloggers can organize their Markdown notes and drafts into collections, using qmd to find related content for articles or projects. The hybrid search capabilities help uncover semantic connections between ideas, enhancing creativity and content planning.
Law firms can index case notes and legal briefs in Markdown, enabling quick searches for precedents or specific clauses during case preparation. The tool's fast keyword search ensures efficient access to critical documents without relying on external databases.
Offer a free tier for individual users with basic search features, and charge teams for advanced capabilities like collaborative indexing, priority support, and cloud sync. Revenue comes from monthly subscriptions based on the number of users or collections.
Sell licenses for on-premises deployment to large organizations with strict data privacy requirements, providing custom integrations, dedicated support, and training. Revenue is generated through one-time license fees or annual maintenance contracts.
Provide consulting to help businesses set up and optimize qmd for their specific use cases, such as integrating with existing document management systems or developing custom plugins. Revenue comes from hourly rates or project-based fees.
💬 Integration Tip
Set up automated indexing via cron jobs to keep search results fresh, and use the --json flag for easier parsing in automated workflows or agent integrations.
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.