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.

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.8.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.8.0
File Size Uploaded Provenance Actions
ranwhat-0.8.0.tar.gz 1.6 MB Without provenance Details for ranwhat-0.8.0.tar.gz

Built distribution (wheel)

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

Total release size: 2.3 MB

Release files / ranwhat-0.8.0.tar.gz

Download URL ranwhat-0.8.0.tar.gz
Size 1.6 MB
Tags Source
SHA-256 checksum
How to use checksums
a23c2323f88d9a2c1eb21e4ae2ec80d2243c25e28305cc4dc64c67236f6dffc2
BLAKE2b-256 checksum
How to use checksums
451bd394ecf583c108d157807de9fe361b55f896487b4c23c6d6b0046ea85b0f
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.8.0-py3-none-any.whl

Download URL ranwhat-0.8.0-py3-none-any.whl
Size 736.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
301f675159a230a0e7358191491fb50db13ee885dfac8f1749204b58ab57c5ec
BLAKE2b-256 checksum
How to use checksums
a882f5dc0ccaad45dfdf8f4911d177ca47f6fb3c0d3406512662e2308da08fe1
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.8.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