Tutorial¶
Search prompts¶
Search user prompts across all supported stores:
$ uv run agentgrep grep "draft pr"
Search only Codex prompts:
$ uv run agentgrep grep "draft pr" --agent codex
Ranked search¶
search ranks, dedupes, and groups results by session — the smart
default when you want the most relevant matches first:
$ uv run agentgrep search "draft pr"
Sweep prompts and conversations together:
$ uv run agentgrep search "draft pr" --scope all
Search conversations¶
Search assistant, tool, event, and full conversation records:
$ uv run agentgrep grep "pytest" --scope conversations
Search prompts and conversations together:
$ uv run agentgrep grep "docs" --scope all
Combine terms¶
Require every term:
$ uv run agentgrep grep docs deploy
Use regular expressions (regex is the default):
$ uv run agentgrep grep "docs?.*deploy"
Return structured output¶
Pretty JSON:
$ uv run agentgrep grep "release" --json
Line-delimited JSON:
$ uv run agentgrep grep "release" --ndjson