Tobi Lutke 99aee71903

Update get and multi-get commands for virtual paths

- Update getDocument() to support qmd:// virtual paths and filesystem paths
- Update multiGet() to handle virtual paths in patterns and comma-separated lists
- Update matchFilesByGlob() in store.ts to return virtual paths
- Remove duplicate getContextForFile() function from qmd.ts
- Use collection-scoped getContextForPath() instead of legacy function
- All get and multi-get tests now passing

Closes qmd-vro

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

2025-12-12 15:47:42 -05:00

3.0 KiB

Raw Blame History

QMD - Quick Markdown Search

Note: This project uses bd (beads) for issue tracking. Use bd commands instead of markdown TODOs. See AGENTS.md for workflow details.

Use Bun instead of Node.js (bun not node, bun install not npm install).

Commands

qmd add .                      # Index markdown files in current directory
qmd context add [path] "text"  # Add context for path (defaults to current dir)
qmd context list               # List all contexts
qmd context rm <path>          # Remove context
qmd status                     # Show index status and collections
qmd update                     # Re-index all collections
qmd embed                      # Generate vector embeddings (requires Ollama)
qmd search <query>             # BM25 full-text search
qmd vsearch <query>            # Vector similarity search
qmd query <query>              # Hybrid search with reranking (best quality)
qmd get <file>                 # Get document content (fuzzy matches if not found)
qmd multi-get <pattern>        # Get multiple docs by glob or comma-separated list

Context Management

# Add context to current directory (auto-detects collection)
qmd context add "Description of these files"

# Add context to a specific path
qmd context add /subfolder "Description for subfolder"

# Add global context to all collections (system message)
qmd context add / "Always include this context"

# Add context using virtual paths
qmd context add qmd://journals/2024 "Journal entries from 2024"

# List all contexts
qmd context list

# Remove context
qmd context rm qmd://journals/2024
qmd context rm /  # Remove global context

Options

# Search & retrieval
-c, --collection <name>  # Restrict search to a collection (matches pwd suffix)
-n <num>                 # Number of results
--all                    # Return all matches
--min-score <num>        # Minimum score threshold
--full                   # Show full document content

# Multi-get specific
-l <num>                 # Maximum lines per file
--max-bytes <num>        # Skip files larger than this (default 10KB)

# Output formats (search and multi-get)
--json, --csv, --md, --xml, --files

Development

bun qmd.ts <command>   # Run from source
bun link               # Install globally as 'qmd'

Architecture

SQLite FTS5 for full-text search (BM25)
sqlite-vec for vector similarity search
Ollama for embeddings (embeddinggemma) and reranking (qwen3-reranker)
Reciprocal Rank Fusion (RRF) for combining results

Important: Do NOT run automatically

Never run qmd add, qmd add-context, qmd embed, or qmd update-all automatically
Never modify the SQLite database directly
Write out example commands for the user to run manually
Index is stored at ~/.cache/qmd/index.sqlite

Do NOT compile

Never run bun build --compile - it overwrites the shell wrapper and breaks sqlite-vec
The qmd file is a shell script that runs bun qmd.ts - do not replace it

3.0 KiB Raw Blame History