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.

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.9.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.9.0
File Size Uploaded Provenance Actions
ranwhat-0.9.0.tar.gz 1.6 MB Without provenance Details for ranwhat-0.9.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ranwhat 0.9.0
File Interpreter ABI Platform Actions
ranwhat-0.9.0-py3-none-any.whl Python 3 none any Details for ranwhat-0.9.0-py3-none-any.whl

Total release size: 2.3 MB

Release files / ranwhat-0.9.0.tar.gz

Download URL ranwhat-0.9.0.tar.gz
Size 1.6 MB
Tags Source
SHA-256 checksum
How to use checksums
1afd326657c204b95c19af5edd996453ad372dafb0f2f4a6ee1858e8d4d95673
BLAKE2b-256 checksum
How to use checksums
2ee9e970a246835c3d171ab79c6e3000f27edd3f6bcb5555a958c4c2d6daf3fb
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.9.0-py3-none-any.whl

Download URL ranwhat-0.9.0-py3-none-any.whl
Size 743.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
96f39681679fef8bca4f75ac23d5d8f70c7b6dc3abfa52543fbe2e7077382ca6
BLAKE2b-256 checksum
How to use checksums
5a7e38496aae58c1961fb0a675673c3a3f7081d14077bec459cfe23d5b1e1406
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.9.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