Skip to main content

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 check in 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)

Source distribution for ranwhat 0.10.0
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)

Table of built distributions (wheels) for ranwhat 0.10.0
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page