08 · Scout remembers
Searchable session history and label-scoped work sets.
Goal
Find prior agent work without keeping notes — search past harness sessions and reconstruct labelled work sets.
You need
01–07 done; some real sessions behind you helps.
The idea
Two different memories. Broker records — messages, asks, flights — are
first-party records. Harness transcripts (Claude Code, Codex,
Kimi sessions on disk) are observed material: Scout can index them for
search, explicitly and on demand, without importing them as Scout messages.
scout search is the front door to the second kind — use it before grepping
~/.claude or ~/.codex by hand.
The session-search guide covers supported harnesses, local storage, coverage, and the full command reference.
Walk it
Check index coverage
What is indexed, per harness, per time range.
Warm the index deliberately
Indexing is explicit, never ambient — you choose the window and the source.
Query it
Results point back at the session that did the work — which agent, which commands, cwd — the answer to "who touched this and what did they run."
Reconstruct a work set
If 07's asks carried --label, these rebuild the whole thread of
related work; watch turns it into a live feed.
How to tell it worked
search statusshows indexed coverage after an explicitindexrun.- A
queryreturns the session that did matching work. label feedlists everything tagged in the window.
Push further
- Index before you need it: a warm index over the last few days turns "didn't someone fix this already?" into a five-second query.
scout session listandscout session touched <id>show what files a session was observed to modify.- Found a Codex session worth continuing?
scout session fork <id>wraps Codex's interactive fork flow. Other harnesses are not supported by this command. Continuing an exact Scout-routed session is a separate operation:scout ask --to session:<id> "Continue the work".
Next
09 — Everywhere you are: the same broker, on your desktop, your phone, and your other machines.