# agentgrep

> Read-only search for local AI agent prompts and history across Codex, Claude Code, Cursor, and Gemini.

## Documentation

- [Getting Started](https://agentgrep.org/getting-started/): One path from a checkout to a useful search result.
- [CLI](https://agentgrep.org/cli/): The agentgrep CLI is the fastest path to your local AI agent prompt and history archives from a terminal. It wraps the same read-only discovery and parsing layer the MCP server exposes — grep, find...
- [TUI](https://agentgrep.org/tui/): The agentgrep ui command launches the interactive Textual explorer over the same Codex, Claude Code, Cursor, and Gemini stores the rest of the CLI walks. It is read-only — agentgrep never mutates t...
- [Library](https://agentgrep.org/library/): Use agentgrep as a Python library from your own scripts and tools. The same search, discovery, parsing, serialization, and path-privacy layer powers the terminal CLI and the MCP server, so anything...
- [MCP](https://agentgrep.org/mcp/): agentgrep’s MCP server exposes a read-only search surface over stdio. It does not mutate local agent stores, open SQLite in write mode, or execute arbitrary shell commands.
- [Development](https://agentgrep.org/dev/): Contributing and internals references — material for people poking at agentgrep’s source, writing new adapters, or running benchmarks across the commit history. None of this ships in the published ...
- [Changelog](https://agentgrep.org/history/): To install the unreleased agentgrep version:

## Documentation

- [agentgrep find](https://agentgrep.org/cli/find/): The agentgrep find command enumerates the on-disk prompt and history stores agentgrep can read — Codex session files, Claude Code JSONL transcripts, Cursor SQLite databases, Gemini history. Use it ...
- [agentgrep fuzzy](https://agentgrep.org/cli/fuzzy/): The agentgrep fuzzy command is a non-interactive fuzzy filter shaped like fzf --filter. It reads candidate lines from stdin, scores them against your query, and emits the matches in descending scor...
- [agentgrep grep](https://agentgrep.org/cli/grep/): The agentgrep grep command searches normalized prompt and history records with the flag grammar and output behavior of ripgrep and the_silver_searcher. If you already reach for rg -i or ag -F witho...
- [API Reference](https://agentgrep.org/cli/reference/): CLI argument types, serialization helpers, and command entry points.
- [Benchmark harness](https://agentgrep.org/dev/benchmark/): scripts/benchmark.py is a cross-commit benchmark runner that walks hyperfine across HEAD, trunk, a range, the last N commits, an explicit list of tags / SHAs, or just HEAD vs. trunk. It surfaces un...
- [Storage catalogue](https://agentgrep.org/dev/storage-catalog/): agentgrep keeps an explicit catalogue of every on-disk store it knows about, modelled as Pydantic StoreDescriptor rows aggregated under one StoreCatalog. The catalogue is descriptive: it documents ...
- [MCP Clients](https://agentgrep.org/getting-started/clients/): agentgrep exposes a local stdio MCP server. Any MCP client that can launch a command can run it.
- [Configuration](https://agentgrep.org/getting-started/configuration/): agentgrep is intentionally low-configuration. It reads known local agent stores under the current user’s home directory and never mutates them.
- [Installation](https://agentgrep.org/getting-started/installation/): Python 3.14
- [Event-stream engine](https://agentgrep.org/library/event-stream/): agentgrep’s search and find engines produce typed event streams — sync generators that yield pydantic discriminated-union events as they walk the user’s stores. The same producer feeds the CLI’s li...
- [Examples](https://agentgrep.org/library/examples/)
- [How to](https://agentgrep.org/library/how-to/): Filter discovery to Codex session files:
- [Query language](https://agentgrep.org/library/query-language/): agentgrep grep, agentgrep grep, and agentgrep find accept a Lucene-style query language for inline field predicates, boolean composition, and date ranges. The same syntax works across all three sub...
- [API Reference](https://agentgrep.org/library/reference/): Core data types, discovery functions, and the search pipeline used by every surface (CLI, TUI, MCP).
- [Tutorial](https://agentgrep.org/library/tutorial/): Search user prompts across all supported stores:
- [Prompts](https://agentgrep.org/mcp/prompts/): MCP prompts are reusable recipes a client can render before calling tools.
- [API Reference](https://agentgrep.org/mcp/reference/): FastMCP server factory, payload models, and MCP helpers.
- [Resources](https://agentgrep.org/mcp/resources/): MCP resources expose passive read-only data at agentgrep:// URIs. Clients read them with resources/read.
- [Tools](https://agentgrep.org/mcp/tools/): agentgrep’s tools are read-only. They return structured Pydantic models and protect private paths before serialization.
- [API Reference](https://agentgrep.org/tui/reference/): The agentgrep.ui subpackage holds the streaming Textual explorer. Textual is imported lazily inside build_streaming_ui_app() via importlib.import_module, so bare import agentgrep does not pull Text...