Knowledge Cache
synapse_knowledge_cacheCache code search insights and summaries, record feedback for repeated patterns, and query learned associations to avoid re-searching code and cut token usage.
Instructions
Manages persistence, feedback loops, and learning metadata within the codebase graph. High-level actions include:
'learn': records explicit query-to-chunk relevance; repeated evidence promotes cache hits.
'save_summary': persists single or batch plain-English annotations on code chunks.
'suggest': lists high-value chunks needing summary based on access history and traffic weight.
'query': searches cached summaries, identifiers, and exact learned associations to recall established patterns.
REPLACES: repeated searches for the same patterns, manual note-taking, re-discovering code paths. Use this tool instead of these alternatives for better results with 30-60% fewer tokens via automatic compression.
Usage (short): Record search feedback signals, save chunk summaries, suggest docs tasks, and query cached patterns.
Usage (long): Save feedback signals to cache search queries, write natural language summaries for chunks, suggest highest priority needs_summary targets, and query established patterns.
Call 'learn' after useful search results to record explicit query-to-chunk relevance; a single learn signal is queryable immediately but remains provisional until repeated evidence promotes it. Call 'save_summary' to permanently annotate chunks with natural language descriptions. Call 'query' with natural language, filenames, symbols, or chunk IDs to retrieve matching summarized chunks and exact learned associations.
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": {
"action": "<action>"
},
"name": "synapse_knowledge_cache"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | The action to perform. | |
| max_tokens | No | Approximate final response budget in tokens (500-32000, default 4000). | |
| compress_payload | No | Set false to disable lossless response-key compression. |