feat: promote query as primary search command, add CLI aliases

List query first in --help as the recommended search method. Add
vector-search and deep-search as undocumented CLI aliases matching
MCP tool names.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Tobi Lütke 2026-02-13 00:34:29 -05:00
parent 993628e768
commit 96634da39b
2 changed files with 8 additions and 6 deletions

View File

@ -19,9 +19,9 @@ qmd multi-get <pattern> # Get multiple docs by glob or comma-separated
qmd status # Show index status and collections
qmd update [--pull] # Re-index all collections (--pull: git pull first)
qmd embed # Generate vector embeddings (uses node-llama-cpp)
qmd search <query> # BM25 full-text search
qmd vsearch <query> # Vector similarity search
qmd query <query> # Hybrid search with reranking (best quality)
qmd query <query> # Search with query expansion + reranking (recommended)
qmd search <query> # Full-text keyword search (BM25, no LLM)
qmd vsearch <query> # Vector similarity search (no reranking)
qmd mcp # Start MCP server (stdio transport)
qmd mcp --http [--port N] # Start MCP server (HTTP, default port 8181)
qmd mcp --http --daemon # Start as background daemon

View File

@ -2118,9 +2118,9 @@ function showHelp(): void {
console.log(" qmd update [--pull] - Re-index all collections (--pull: git pull first)");
console.log(" qmd embed [-f] - Create vector embeddings (800 tokens/chunk, 15% overlap)");
console.log(" qmd cleanup - Remove cache and orphaned data, vacuum DB");
console.log(" qmd search <query> - Full-text search (BM25)");
console.log(" qmd vsearch <query> - Vector similarity search");
console.log(" qmd query <query> - Combined search with query expansion + reranking");
console.log(" qmd query <query> - Search with query expansion + reranking (recommended)");
console.log(" qmd search <query> - Full-text keyword search (BM25, no LLM)");
console.log(" qmd vsearch <query> - Vector similarity search (no reranking)");
console.log(" qmd mcp - Start MCP server (stdio transport)");
console.log(" qmd mcp --http [--port N] - Start MCP server (HTTP transport, default port 8181)");
console.log(" qmd mcp --http --daemon - Start MCP server as background daemon");
@ -2365,6 +2365,7 @@ if (import.meta.main) {
break;
case "vsearch":
case "vector-search": // undocumented alias
if (!cli.query) {
console.error("Usage: qmd vsearch [options] <query>");
process.exit(1);
@ -2377,6 +2378,7 @@ if (import.meta.main) {
break;
case "query":
case "deep-search": // undocumented alias
if (!cli.query) {
console.error("Usage: qmd query [options] <query>");
process.exit(1);