Guard And Guide

Motivation

You tell your AI coding agent: "Don't run `git push`."

The agent gets blocked — and tries harder:

🧑 deny(git push)
🤖 Got it! I'll use /usr/bin/git push instead.
🧑 NOOO!!!

AI agents don't give up when simply denied. They try absolute paths, alternative commands, and creative workarounds to get the job done.

**guard-and-guide** solves this by not only blocking dangerous operations, but also telling the agent _why_ it was blocked and _what to do instead_. When given clear guidance, agents are much more likely to comply.

Install

nix

nix profile install github:kawarimidoll/guard-and-guide

cargo

cargo install --git https://github.com/kawarimidoll/guard-and-guide

Setup

1. Create rules

Create `~/.config/guard-and-guide/rules.toml` with your rules. See [`rules.example.toml`](rules.example.toml) for a full example.

Rules use canonical tool names (`Bash`, `File`) and regex patterns:

version = 1

[[rules]]
matcher = "File"
regex = '\.env$'
message = "Access