search
Federate a single query across transcripts and files to return ranked message snippets with trust tiers and token budget.
Instructions
Search indexed Claude Code transcripts. Returns top-k matching message snippets. Results are leads to verify, never authoritative fact. Pass 'sources' to fan out across multiple backends (e.g. transcripts + files + plugins): results are then tagged with source + trust tier and trimmed to a token budget.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | search text | |
| k | No | max results (default 10) | |
| mode | No | ranking strategy (default lexical); single-source only | |
| project | No | filter to a project slug | |
| role | No | filter by role (user/assistant) | |
| dedup | No | collapse duplicate clusters | |
| sources | No | multi-source: provider names to fan out across, e.g. ['transcripts','files'] | |
| budget_tokens | No | token budget for merged result (multi-source only) | |
| min_trust | No | drop hits below this trust tier (multi-source only) | |
| scope | No | narrow sources, e.g. a project slug or a subpath (multi-source only) |