Recap
cmd/crewship/cmd_recap.go produces a structured summary of an existing chat session by dispatching the transcript through the default agent. Useful when picking up an older thread, sharing a session with a teammate, or auditing what an agent actually did across many turns.
Pulls up to 500 messages (same cap as crewship chat), compresses tool-call noise to names only, truncates each turn at 800 characters to keep prompt tokens bounded, then re-uses crewship ask’s streaming pipeline so output renders incrementally.
crewship recap <chat-id>
| Flag | Type | Default | Effect |
|---|---|---|---|
--agent <slug> | string | default-agent | Agent slug used to generate the summary. Falls through to default_agent config when unset. |
--bullets <n> | int | 8 | Cap on the “Key decisions” section. |
Examples
Output shape
The summarising agent is instructed to produce a markdown block with these sections, in order, with no preamble:- Final outcome — one sentence
- Key decisions — up to
--bulletsitems - Open threads — anything unresolved, or
(none) - What to ask next — one suggested follow-up prompt
Common errors
chat <id> has no messages— the chat is empty or doesn’t exist.internal: ask command has no RunE— wiring error; should not appear in shipped builds.
See also
crewship ask— the underlying one-shot prompt path.crewship resume <chat-id>— pick up the session instead of summarising it.crewship explain <run-id>— same idea, scoped to one run via journal entries.