macOS
Apple SiliconThat is macOS Gatekeeper flagging an unsigned app. It is normal — not file corruption and not a broken download. After dragging RippleCheck into Applications, open Terminal and run this once:
sudo xattr -rd com.apple.quarantine /Applications/RippleCheck.app
macOS will ask for your Mac password — type it (the characters stay hidden as you type) and press Enter. Then launch RippleCheck normally — the warning is gone for good.
Windows
Early buildNeither installer is code-signed yet. macOS Gatekeeper and Windows SmartScreen will both warn you the first time you open the app. The steps below show how to get past that. Every release is built from the public source on GitHub, so you can also build it yourself if you'd rather not trust a binary.
Installing on macOS
Takes about a minute. The right-click step is only needed once.
- Download RippleCheck-0.1.1-arm64.dmg using the button above.
- Open the
.dmgfile. A window appears with the RippleCheck icon and an Applications shortcut. - Drag RippleCheck into Applications. Then eject the disk image.
- Right-click the app in Applications and choose “Open” — do not double-click it the first time. A dialog appears saying the developer cannot be verified. Click Open. macOS remembers this choice, so every launch after this one is a normal double-click.
- Point RippleCheck at a project folder and it starts watching immediately.
Intel Macs: this build is Apple Silicon (arm64) only. On an Intel Mac, build from source instead — it is a few commands and works fine.
Installing on Windows
The Windows installer is built and contains the right files, but it has not been run on real Windows hardware yet. It should work — treat it as an early build and please report anything that doesn't.
- Download RippleCheck.Setup.0.1.1.exe using the button above.
- Run the installer. Windows SmartScreen will show a blue “Windows protected your PC” screen because the file isn't signed.
- Click “More info”, then “Run anyway”. The installer proceeds normally from there.
- Follow the installer prompts. RippleCheck lands in your Start menu when it finishes.
- Open it, choose a project folder, and it starts watching.
Hit a problem on Windows? Open an issue — Windows reports are genuinely useful right now, since the build is untested on real hardware.
Don't want the app?
The same scanner runs three other ways. None of them require a download.
MCP server
One command wires it into Claude Code, Cursor, or any MCP client.
Claude Code hooks
Reports automatically after your assistant finishes editing. No prompting.
CLI
npx it against any folder and read the result as JSON or plain English.
# MCP server — Claude Code
$ claude mcp add ripplecheck --scope user -- npx -y ripplecheck-mcp
# One-off scan of any project
$ npx -p ripplecheck-mcp ripplecheck /path/to/project