Quickstart¶

1. Install dependencies¶

From the repository root:

$ uv sync --all-groups

2. Search local agent history¶

Search all supported stores:

$ uv run agentgrep search "release notes"

Search one agent’s prompt records:

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

3. Inspect the stores¶

See which files and databases agentgrep can read:

$ uv run agentgrep find

Filter discovery output:

$ uv run agentgrep find sessions --agent codex

4. Use MCP¶

Run the local stdio server:

$ uv run agentgrep-mcp

Or run the FastMCP config:

$ uv run fastmcp run fastmcp.json

See MCP Clients for MCP client snippets.

Next steps¶

• Tutorial walks through CLI search in more detail.

• Tools documents the MCP tool payloads.

• Configuration explains output, progress, privacy, and source selection.