qmdlisted

# qmd - Quick Markdown Search Local search engine for Markdown notes, docs, and knowledge bases. **Use this to find relevant files BEFORE reading them** to dramatically reduce token usage. ## When to Use (IMPORTANT) **ALWAYS prefer qmd search over reading files directly when:** - Exploring a codebase or documentation - Looking for specific functionality or concepts - Finding related files to a topic - Answering questions about the codebase **Token savings:** Instead of reading 5 files (5000+ tokens), search first (50 tokens) and read only the relevant sections (200 tokens). ## Search Priority (follow this order) 1. **`qmd search "query"`** - Fast BM25 keyword search. Use this first, it's instant. 2. **`qmd vsearch "query"`** - Semantic similarity. Use only if keyword search fails. 3. **`qmd query "query"`** - Hybrid + reranking. Avoid unless user explicitly requests highest quality. ## Common Commands ```bash # Fast keyword search (DEFAULT - use this first) qmd search "authentication" -n 10 # Search specific collection qmd search "api routes" -c my-project # Get file paths only (for deciding what to read) qmd search "database schema" --files # JSON output for parsing qmd search "error handling" --json # Semantic search (slower, use as fallback) qmd vsearch "how does the login flow work" ``` ## Retrieve Documents ```bash # Get specific file qmd get "path/to/file.md" # Get by document ID from search results qmd get "#docid" # Get multiple files qmd multi-get "do