coding.sh search
Full-text search over prompts, replies and tool calls. Every option of coding.sh search, from its own --help.
coding.sh search <TEXT>... [options]
Full-text search over prompts, replies and tool calls
Arguments
text Search text
Options
-a, --agent <AGENT> Only sessions from this agent (repeatable, or a comma list: a,b)
-n, --limit <N> Maximum rows (default: 20)
--project <ID> Only matches in this serve project (default: all)
--where <QUERY> Only matches matching a query, e.g. 'agent:codex cost>0.5 tool:Bash -flag:compaction' (keys: coding.sh sessions --help)
--fresh Wait for every pending capture to be ingested (default: answer after 1.5 s)
Examples
coding.sh search 'flaky test'
coding.sh search migration --where 'agent:codex kind:tool.start'
Notes
Every word must appear in a match as a whole word, and the last word may also start a longer one: 'refactor tokeni' finds 'refactor the tokenizer'.
Matches are listed best first. When a search matches more than 20,000 events (a word as common as 'the'), the local store lists them newest first instead.
--where applies to each match: event keys (kind, tool, ok, …) to the matching event, session keys (agent, repo, cost, …) to its session. Keys: coding.sh sessions --help.
With --json, an answer given before every capture was indexed carries "pending": {"files": N, "indexing": true|false} (files still to ingest; indexing: an ingest is still running). The field is absent once all are indexed.