/ \__
  (    @\___
  /         O
 /   (_____/
/_____/   U

heel

access control for your ai agents

read the docs

open source · self-hosted · node 26.13 or later

heel · activity
inbox-botgmail-work search "in:inbox"allow2 hidden from the result
inbox-botgmail-personal send → dana@clientco.comdenypersonal never emails clients
inbox-botgmail-work reply_all → sam@customer.comasksent to your phone
↳ approved with a passkey by avisentran once
inbox-botgmail-work trash 340 messagesaskover 20 this run
↳ paused from the phone by avipausednothing ran
activity.log

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

quick start