| name | qmd-search |
| description | qmd - Search local markdown notes, documentation, and Claude session history. Use when user says "qmd", "search notes", "find docs", "search sessions", "local search", "knowledge base search", or needs to retrieve markdown files. |
qmd - Quick Markdown Search
Fast local search engine for markdown notes, documentation, and Claude session history.
Quick Start
qmd search "authentication flow"
qmd get "path/to/file.md"
qmd search "react hooks" -c claude-sessions
Search Modes
qmd search (Default - Use This)
BM25 keyword matching. Instant results.
qmd search "error handling"
qmd search "typescript generics" -n 10
qmd search "api design" --json
qmd vsearch (Use Sparingly)
Vector similarity search. Slower - loads local models on each run.
qmd vsearch "concepts similar to dependency injection"
qmd query (Avoid)
Hybrid search with LLM reranking. Slowest, often less reliable.
Common Commands
Search
qmd search "query"
qmd search "query" -n 10
qmd search "query" -c collection
qmd search "query" --json
qmd search "query" --files
qmd search "query" --full
qmd search "query" --all --min-score 0.3
Retrieve Documents
qmd get "path/to/file.md"
qmd get "path/to/file.md:50"
qmd get "path/to/file.md" -l 100
qmd multi-get "journals/2025-01*.md"
qmd multi-get "doc1.md, doc2.md"
Collections
qmd collection list
qmd collection add /path --name notes --mask "**/*.md"
qmd ls
qmd ls collection-name
Maintenance
qmd status
qmd update
qmd embed
Output Formats
| Flag | Description |
|---|
--json | JSON with snippets |
--files | docid, score, filepath, context |
--csv | CSV output |
--md | Markdown output |
--xml | XML output |
--full | Complete document content |
Search Options
| Option | Description |
|---|
-n <num> | Number of results (default: 5) |
-c, --collection <name> | Filter to collection |
--all | Return all matches |
--min-score <num> | Minimum similarity score |
--line-numbers | Add line numbers |
Guidelines
- Prefer
qmd search - instant BM25 keyword matching
- Use
qmd vsearch sparingly - slow due to model loading
- Avoid
qmd query - hybrid search often unreliable
- Use
--json or --files for agent-friendly output
- Use
-c collection to narrow scope when you know the target
Index location: ~/.cache/qmd/index.sqlite