/ \__ ( @\___ / O / (_____/ /_____/ U
heel
access control for your ai agents
open source · self-hosted · node 26.13 or later
heel · activity
| inbox-bot | gmail-work search "in:inbox" | allow | 2 hidden from the result |
| inbox-bot | gmail-personal send → dana@clientco.com | deny | personal never emails clients |
| inbox-bot | gmail-work reply_all → sam@customer.com | ask | sent to your phone |
| ↳ approved with a passkey by avi | sent | ran once | |
| inbox-bot | gmail-work trash 340 messages | ask | over 20 this run |
| ↳ paused from the phone by avi | paused | nothing ran |
say what the agent is for
rules are a file you can read, review and test. the first match decides, and a call no rule matches is denied. these are the rules behind the activity above.
how rules work →rules/owner.yaml
rules: - match: { kind: read } then: allow # the personal account never emails clients - match: action: email.send account: gmail-personal recipients: { any_domain_in: [clientco.com] } then: deny # coworkers already in the thread - match: action: email.send recipients: all_in_thread: true all_domain_in: [company.com] then: allow - match: { action: email.send } then: ask # count messages, not calls - match: action: email.remove items: { over: 20, per: run } then: ask - match: action: email.remove items: { over: 100, per: hour } then: ask
- rules on the arguments
- who an email goes to, which account it comes from, which repo, whether ci passed, how many messages this run deleted. one yaml file for mcp, http and cli. nothing matched means deny.
- approvals it can’t answer
- an ask waits for its owner, who sees the full call and approves with a passkey, outside the agent’s session.
- hiding what it reads
- mail from people you name, password resets and login codes drop out before the agent sees them.
- one switch to stop it
- pause an agent, an account or everything from your phone. even an approved call stops.
- no model decides a call
- whoever shapes a call could shape a model judging it. rules, grants and people decide.
- yours to run
- open source, self-hosted, one process. heel holds the credentials; agents only get a heel token.
give your agent a heel