recall
Semantically search past AI agent sessions to retrieve verbatim passages of decisions, attempts, findings, and measurements; use before re-deriving or claiming something was never built or discussed.
Instructions
Semantic search over the user's past AI agent sessions: describe what you are after, get back the verbatim passages — what was decided, tried, measured or investigated. Call it when they refer to earlier work, or when you are about to re-derive something a session may already have settled. Call it too before claiming that something was never built, was dropped, or was never discussed: the code cannot show that, only the sessions can. Ranked top-k, so it gives you a foothold on a topic, not every session touching it. Ranking weighs relevance, not age: for the latest word on a topic, or one stretch of time, bound it with since/until. Each hit is a passage you will read: k is the token cost, candidates the reach, and a pool larger than k is reranked, at seconds of latency that grow with the pool, so the reach can grow without the reading.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| k | No | Hits returned (default 8). Each is a verbatim passage of a few hundred tokens, so `k` is what a call costs to read. | |
| repo | No | Restrict to turns whose checkout resolved to this repo, as `owner/name` | |
| role | No | Restrict to a role, as the turns carry it (an agent's turns say user | assistant | tool | system) | |
| query | Yes | Natural-language description of what to recall from past sessions. A query matches best in the language they are written in, which `status` reports. | |
| since | No | Restrict to turns on or after this date, `YYYY-MM-DD` | |
| until | No | Restrict to turns on or before this date, `YYYY-MM-DD` | |
| memory | No | Memory to read for this call, as it stands — `<org>/<repo>`, an `hf://…` URI, a local path, or `local`. Omitted, the server's memory, with this host's turns not yet pushed to it when the host is bound to it. | |
| harness | No | Restrict to a harness facet, as the turns carry it (`claude` also matches the older `claude_code`) | |
| neighbors | No | Adjacent chunks attached to each hit for context; 0 returns the hits alone. | |
| block_type | No | Restrict to a block type: text | thinking | tool_use | tool_result | |
| candidates | No | Size of the fused pool the hits are cut from (default 30): how far the search looks. Larger than `k`, the pool is reranked by the cross-encoder before the cut, which costs seconds and grows with the pool, so `k` can stay small while the search looks deep. A pool of `k` rows or fewer is read whole, in the fused order. |