Search Knowledge Stores

Search Knowledge Stores

Search indexed library sources for: $ARGUMENTS

Steps

1. Parse the query from $ARGUMENTS:

   • Extract the search query (required)
   • Extract --stores parameter (optional, comma-separated store names)
   • Extract --limit parameter (optional, default 10)
   • Extract --mode parameter (optional: vector, fts, hybrid; default hybrid)
   • Extract --detail parameter (optional: minimal, contextual, full; default minimal)
   • Extract --threshold parameter (optional, 0-1 range for normalized score filtering)
   • Extract --min-relevance parameter (optional, 0-1 range for raw cosine similarity filtering)

2. Call mcp__agent-knowledge__search with:

   • query: The search query string
   • stores: Array of store names (if --stores specified)
   • limit: Number of results (if --limit specified, default 10)
   • mode: Search mode (if --mode specified, default "hybrid")
   • detail: Detail level (if --detail specified, default "minimal")
   • threshold: Minimum normalized score (if --threshold specified)
   • minRelevance: Minimum raw cosine similarity (if --min-relevance specified)
   • intent: "find-implementation"

3. Format and display results with rich context:

   ## Search Results: "query" (hybrid search)
   
   **1. [Score: 0.95] [Vector+FTS]**
   Store: claude-code
   File: 📄 path/to/file.ts
   Purpose: → Purpose description here
   Top Terms: 🔑 (in this chunk): concept1, concept2, concept3
   Imports: 📦 (in this chunk): package1, package2
   
   **2. [Score: 0.87] [Vector]**
   Store: another-store
   File: 📄 path/to/file.js
   Purpose: → Another purpose here
   Top Terms: 🔑 (in this chunk): other-concept
   
   ---
   **Found 10 results in 45ms**
   
   💡 **Next Steps:**
   - Read file: `Read /path/to/file.ts`
   - Get full code: `mcp__agent-knowledge__get_full_context("result-id")`
   - Refine search: Use keywords above
   

   Formatting rules:

   • Header: ## Search Results: "query" (mode search) - Extract mode from response (vector/fts/hybrid)
   • Each result on its own block with blank line between
   • Result header: **N. [Score: X.XX]**
   • Store: Store: storeName
   • File: File: 📄 filename (from summary.location, strip repoRoot prefix)
   • Purpose: Purpose: → purpose text (from summary.purpose)
   • Footer: **Found {{totalResults}} results in {{timeMs}}ms** with separator line above

4. For the footer next steps, include:

   • First result's ID in the get_full_context example
   • First result's actual file path in the Read example
   • Use the actual keywords from top results

5. If no results:

   No results found for "query"
   
   Try:
   - Broadening your search terms
   - Checking indexed stores: /agent-knowledge:stores