Skip to main content
Search recorded chat sessions by keyword, ranked by BM25. Every agent in the workspace is searched unless --agent narrows it. The alias crewship conv search is also supported.
Arguments and flags: The search endpoint understands only the query, --agent and --limit. --chat, --from, --has, --after and --before narrow the page it returns on the client, exactly as the chat’s search box does. When they remove hits from a full page, more matches may exist that the server never sent: the result is marked partial ("partial": true in JSON) — raise --limit to look further. Each hit carries the agent that said it, the session id and the timestamp, so a workspace-wide result stays readable and you can follow up in the right thread.
The agent-first positional form this command shipped with — crewship conversation search backend-bot "deploy pipeline" — still works: when no --agent is given and several arguments are passed, the first is read as an agent. Quote a multi-word phrase (or pass --agent) to search the whole workspace.
Only conversations recorded after conversation search was introduced are indexed. For the API contract and isolation model, see Conversation Search.