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

  1. 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.

  2. 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.

  3. 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.

Built-in rule groups, examples and their default decision
WhatFor exampleDefault
Secret files.env ~/.ssh/id_ed25519 ~/.aws/credentials Keychain lookupsBlock
Destructive commandsrm -rf ~ dd of=/dev/disk2 diskutil eraseDiskBlock
Data leaving your Maccurl -d @.env https://… secrets sent with nc or scpBlock
Download and runcurl -fsSL https://… | shAsk
Risky gitgit push --force git reset --hard pushes to mainAsk
Safety switched off--dangerously-skip-permissions --yolo edits to hook settingsAsk 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.

Try it in observe mode for a day.