A checkpoint between AI coding agents and your Mac.
Claude Code, Codex, Cursor and the others check with Warden before every command and file read. Routine work goes straight through. Reading your keys, wiping folders or piping a script from the internet into a shell is stopped. The grey areas come to you.
macOS 14+ · Apple silicon & Intel · notarized · MIT
Animated replay: Claude Code works through five commands in a sample project. Warden lets ls, npm test and git push through, blocks the read of .env, and asks about curl … | sh, which is then blocked from the popup. Demo data, Balanced preset.
How it works
-
It uses the agent’s own hooks.
Setup adds one entry to each agent’s settings file and saves a backup of that file first. No proxy, no kernel extension, nothing changes in how you start the agent.
-
It decides on your Mac, before the action runs.
A small helper checks each call against built-in rules: block the clear threats, ask about judgment calls, let everything else through. Hard blocks work even when the app is closed.
-
It starts by watching.
You can begin in observe mode. Warden logs what it would have stopped, you adjust the rules, and when the log looks right you press Start enforcing.
What it catches
Defaults on the Balanced preset. Any rule can be set to block, ask or only log.
| What | For example | Default |
|---|---|---|
| Secret files | .env ~/.ssh/id_ed25519 ~/.aws/credentials Keychain lookups | Block |
| Destructive commands | rm -rf ~ dd of=/dev/disk2 diskutil eraseDisk | Block |
| Data leaving your Mac | curl -d @.env https://… secrets sent with nc or scp | Block |
| Download and run | curl -fsSL https://… | sh | Ask |
| Risky git | git push --force git reset --hard pushes to main | Ask |
| Safety switched off | --dangerously-skip-permissions --yolo edits to hook settings | Ask Block |
It isn’t a sandbox, and hooks only see what an agent declares. What it doesn’t catch
Works with
- Claude Codeterminal, IDE extensions
- Codex CLItrust the hook once with
/hooks - Cursoreditor and agent
- Gemini CLIterminal
- WindsurfCascade
- Clineswitch the hook on in Cline
Setup finds the ones installed on your Mac. What each agent lets Warden see
Stays on this Mac
No account. No telemetry. The app makes no network requests of its own.
Decisions and the evidence log live in ~/Library/Application Support/Warden. Keys, tokens and passwords are masked before anything is written. Warden is free and open source (MIT), with no license key, no paid tier and no trial clock. Privacy policy
Questions
Does it slow the agent down?
Not noticeably. Each check is a small native program that answers from local rules, with no network round trip. You only wait when Warden asks you something.
What happens if the app isn’t running?
Hard blocks still apply, because the helper decides on its own. For questions, Claude Code and Cursor fall back to their own permission prompt. For the other agents you choose what happens in Settings; the default is to block and tell the agent to ask you to open Warden.
What if I don’t answer a popup?
After 60 seconds the action is blocked. Both the wait and the fallback can be changed in Settings. On high-risk questions, Return and Esc both choose Block.
Can an agent get around it?
Sometimes. Hooks see what the agent says it will do, so a script written now and run later, or heavy obfuscation, can slip past pattern rules. Warden also blocks edits to its own hooks and warns when they disappear. The full list is on What it doesn’t catch. Found a way around a rule? Report it privately.
Is it really free? Can I read the code?
Yes. Warden is open source under the MIT License, with no paid tier. The rules, the hook helper and the app are all on GitHub, and you can build it yourself with the Command Line Tools. Release builds are signed with an Apple Developer ID and notarized by Apple.
How do I remove it?
On the Agents screen, press Remove for each agent. Only Warden’s entries are taken out, and Restore backup puts back the exact file saved before install. Then quit the app and delete it.