session_search
Keyword search over past session memory and global notes.
A wrapper over search_memory with scope both.
- Tool name
- session_search
- Group
- Memory
- Risk
- none
- Needs approval
- never
- Approval rule
- Read only.
- Allowed in scheduled jobs
- No
- Default
- on
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| query | string | Yes | Words to look for. | ||
| limit | integer | No | 8 | Maximum number of results. |
Returns
Matching excerpts.
Example (made up for this page)
{
"query": "demo"
}session/tg_1001/todo.md: ...Side effects
- none
How it can fail
| When | What the agent sees |
|---|---|
| The query is empty | session_search needs a query. |
See also:Memory tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.