Configuration¶

agentgrep is intentionally low-configuration. It reads known local agent stores under the current user’s home directory and never mutates them.

Agent selection¶

Use --agent one or more times to limit search or discovery:

$ uv run agentgrep search "cache" --agent codex

Supported agents are codex, claude, and cursor. Omitting --agent searches all supported agents.

Search type¶

Use --type to choose records:

$ uv run agentgrep search "docs deploy" --type prompts

Allowed values are prompts, history, and all.

Output¶

Text output is optimized for terminal reading:

$ uv run agentgrep search "release"

Use JSON or NDJSON for scripts:

$ uv run agentgrep search "release" --json

$ uv run agentgrep search "release" --ndjson

Progress and early answers¶

Human text searches show progress by default. Press Enter on a blank line to return the matches collected so far.

$ uv run agentgrep search "bliss" --progress always

Disable progress when scripting:

$ uv run agentgrep search "bliss" --progress never

Privacy¶

Serialized paths are protected before leaving the process. Home-relative paths are displayed as ~/..., and directory paths keep a trailing /, for example ~/.codex/sessions/.

MCP capabilities¶

MCP clients can read agentgrep://capabilities to inspect supported agents, adapters, tools, resources, prompts, and selected optional backends.