ranwhat
ranwhat checks whether any of your secrets have leaked into your coding agents' history, and where. It also checks whether your agent ran anything sketchy: read your SSH key, force-pushed, piped a script from the internet into a shell, published a package.
It reads the history that Claude Code and twenty-nine other coding agents already keep on your disk, including Codex, Gemini CLI, Cursor and GitHub Copilot (full list). It's open source (MIT), runs locally and has no dependencies. No account needed, no telemetry.
Use it as an audit log for your agents after the fact: see what commands Claude Code ran on your machine, and which API keys and passwords ended up in its transcripts.
Install
Try it once without installing anything:
uvx ranwhat check
To keep it, install with pip install ranwhat, uv tool install ranwhat or
brew install MatijaMiki/ranwhat/ranwhat. Needs Python 3.9 or later.
Quick start
ranwhat check
It changes none of your files. It lists the risky things your agents ran in
the last 30 days, and the secrets it finds in those transcripts and where
each one was found (--days 365 looks further back):
ranwhat watch · local agent flight recorder
...
* Credential material accessed 2026-09-30 18:13:00 Bash 9c41e07b2d5a8f13
cat ~/.ssh/id_rsa
-> The agent read a file whose only purpose is to hold secrets. Whatever
it read is now in a model context you do not control.
* Destructive git operation 2026-09-15 17:30:00 Bash e181acd29cf199ab
git push --force origin main
-> History rewriting or branch deletion. This is the class of action
that destroys the record of what else happened.
ranwhat clean · secrets sitting in local transcripts
...
* Stripe live secret key sk_…dc 32 chars seen 8x
read from api/.env
in /Users/you/Desktop/app
Then ranwhat clean walks you through the secrets it found. You can mask
the ones in plain transcript files, see what to rotate, and open each
provider's page to do it. Agents that keep a database, like Cursor, are only
read, and it tells you how to remove the secret there. Masking stops a key
leaking a second time but doesn't un-leak it, so rotate it.
If you want Claude Code to ask you before a high-risk command runs, there's
an opt-in hook: ranwhat hook install.
To keep a record of what watch flagged that shows if it was changed later,
ranwhat ledger record appends it to a hash chain on your machine, and
ranwhat ledger verify names the first line that no longer fits.
Free and paid
Everything that runs on your machine is free and stays free. Plus is €12 a
month per organisation, for the things that need a server: findings from
all your machines and CI runners in one place (ranwhat push), CI tokens
and teammates on your account, and a catalogue of what each token scope
allows, kept up to date. See pricing.
More
- ranwhat.com: docs and guides
- Commands: every command and flag
- GitHub Action:
run
ranwhat checkin CI after the steps where an agent ran; it can fail the job on findings and uploads SARIF - Full reference: where each agent keeps its history, the rules, the ignore file, the Claude Code plugin and exactly what goes online
- Issues
MIT licence. Built by cenner.
Metadata
Release files for ranwhat 0.10.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ranwhat-0.10.0.tar.gz | 1.6 MB | Without provenance | Details for ranwhat-0.10.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ranwhat-0.10.0-py3-none-any.whl | Python 3 | none | any | Details for ranwhat-0.10.0-py3-none-any.whl |
Total release size: 2.3 MB
Release files / ranwhat-0.10.0.tar.gz
| Download URL | ranwhat-0.10.0.tar.gz |
|---|---|
| Size | 1.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bed076eda9c33fd5c8dc6d01ef5233bfc8ebd629d04c8b09467e99ade91c689b
|
|
BLAKE2b-256 checksum How to use checksums |
81a8f3f044e250adca1bde929850c946433718843f40aced296c0415270e4d45
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / ranwhat-0.10.0-py3-none-any.whl
| Download URL | ranwhat-0.10.0-py3-none-any.whl |
|---|---|
| Size | 744.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8693ed22539b60487f2475e01fe3243f512b6a2b7eaae5b565273383013e58de
|
|
BLAKE2b-256 checksum How to use checksums |
166032c53d38f4915693a95cfe835b46e871e29e66d4998ec81c2562daa36f36
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for ranwhat 0.10.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.