search_conversations
Search conversation history using natural language queries to retrieve previous discussions, decisions, and compacted context. Supports filtering by project and date range, with hybrid search and analysis for relevance.
Instructions
Search conversation history for relevant context.
Use this to find:
- Previous discussions about a topic
- Decisions made in earlier sessions
- Context that was compacted away
Args:
query: Natural language query
project_filter: Limit to specific project path
date_from: Inclusive lower timestamp bound. Accepts ISO-8601 datetime
or date-only values such as 2026-06-13.
date_to: Inclusive upper timestamp bound. Accepts ISO-8601 datetime
or date-only values such as 2026-06-15.
limit: Maximum results (default 5, min 1, max 50)
use_hybrid: Use hybrid search (vector + BM25) for better results
(default True)
enable_analysis: Enable query analysis and result evaluation for
improved relevance (default True). Adds 'analysis' and 'evaluation'
to response.
enable_synthesis: Enable result synthesis to combine multiple results
into a coherent summary (default False). Adds 'synthesis' to response
with key_points and deduplicated content.
include_debug: Include detailed timing metrics and decision tracking
in response (default False). Useful for debugging and performance
analysis. Adds 'metrics' to response.
Returns:
Dict with results list and metadata. When enable_analysis=True, includes:
- analysis: Query intent, detected technologies, key terms
- evaluation: Relevance score, completeness assessment
When enable_synthesis=True, includes:
- synthesis: Primary content, key points, code snippets
When include_debug=True, includes:
- metrics: Timing data (query_analysis_ms, search_ms, etc.), decisions made
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | Yes | ||
| date_to | No | ||
| date_from | No | ||
| use_hybrid | No | ||
| include_debug | No | ||
| project_filter | No | ||
| enable_analysis | No | ||
| enable_synthesis | No |