Installation

CLI

go install

go install github.com/cerberauth/cache-detective@latest

Requires Go 1.24 or later.

Homebrew

brew install cerberauth/tap/cache-detective

Docker

docker run --rm ghcr.io/cerberauth/cache-detective scan --url https://example.com/

See the Docker guide for volume mounts, Compose, and CI usage.

From source

1. Clone the repository:

   git clone https://github.com/cerberauth/cache-detective.git
   cd cache-detective

2. Build the binary:

   go build -o cache-detective .

3. Move it to your PATH:

   mv cache-detective /usr/local/bin/

Verify the installation:

cache-detective --version

GitHub Actions

To use cache-detective in a GitHub Actions workflow, see the GitHub Actions guide.

Caution

--aggressive intentionally probes for exploitable cache behavior (cache poisoning, cache deception). Only run it against systems you own or have explicit written permission to test.