Installation

Requirements

  • Python 3.14

  • uv for the development workflow

  • Optional command-line backends: fd, rg, ag, and jq

agentgrep falls back to Python implementations when optional read-only command-line backends are unavailable.

Development install

$ git clone https://github.com/tony/agentgrep.git

$ cd agentgrep

$ uv sync --all-groups

Run the CLI from the checkout:

$ uv run agentgrep search "bliss"

Run the MCP server:

$ uv run agentgrep-mcp

Package install

When published, install the package into an environment that can read your local agent stores:

$ uv pip install agentgrep

or:

$ pip install agentgrep

Optional tools

agentgrep detects available read-only helpers at runtime:

  • fd for source discovery

  • rg or ag for prefiltering text sources

  • jq for JSON string flattening

The selected helpers are reported through the MCP capabilities resource.