cd /news/ai-agents/show-hn-aaf-gate-policy-gate-and-kil… · home › topics › ai-agents › article
[ARTICLE · art-174360] src=github.com ↗ pub= topic=ai-agents verified=true sentiment=· neutral

Show HN: Aaf-gate – policy gate and kill switch for existing agent runtimes

A developer released aaf-gate 1.0.0rc1, a policy gate and kill switch that sits in front of tool calls for existing AI agent runtimes, with its primary target being Hermes Agent pinned at v0.23.1 for a Mac mini appliance track. The tool applies deterministic per-tool-class decisions (read, draft, internal_write), adds a gate-stop/gate-resume/gate-status kill switch, per-window call limits (3600 s; read 160, draft 40, internal_write 80), and an append-only hash-chained SQLite audit log, using only the Python standard library in core/ with 719 local unit tests passing. The author states aaf-gate is not production-ready, not yet device-accepted, makes no compliance claims, and has not been granted Google Gmail Developer Preview access; Pilot 1 scope is reading Gmail, categorizing, and drafting a reply, with no send capability.

key takeaway

aaf-gate 1.0.0rc1 gates agent tool calls by class (read, draft, internal_write) with a kill switch, per-window call limits and a hash-chained SQLite audit log, installable with no third-party Python dependencies.

read3 min views1 publishedNov 22, 2026
Show HN: Aaf-gate – policy gate and kill switch for existing agent runtimes
Image: Michielbdejong (auto-discovered)

Deterministic policy gate, kill switch, call limits and tamper-evident audit for existing AI agent runtimes. Not an agent of its own. Models, providers and the agent loop are not reimplemented. The primary runtime is Hermes Agent (pinned at v0.23.1 for the Mac mini appliance track). Adapters can target other runtimes later.

Core version 1.0.0rc1 (v1 candidate). See CHANGELOG.md, docs/v1/STATUS.md and docs/v1/INSTALLATION-AND-OPERATIONS.md.

aaf-gate sits in front of tool calls and applies a deterministic policy per tool class:

  • read — allow or deny reads (for example Gmail search)
  • draft — allow or deny drafts (for example a reply draft; sending is out of scope)
  • internal_write — allow or deny internal writes (for example labels); unattended internal writes stay blocked

It also provides:

  • a kill switch (gate-stop /gate-resume /gate-status ) that stops further work for a principal
  • call limits per time window and tool class (tool-call counts, not model-token cost)
  • an append-only, hash-chained audit log in SQLite
  • backup and restore with a chain anchor (gate-backup /gate-restore )
  • versioned, locked industry templates and example customer profiles
  • a device acceptance pack for a Mac mini appliance (track A)

Pilot 1 scope: read Gmail, categorize, and draft a reply. No send.

tool call
  → gate            (class decision)
  → GateKeeper      (policy, limits, kill switch, audit)
  → hermes_adapter  (Hermes hook mapping)
  → gatesocket      (Unix socket)
  → Hermes plugin aaf-gate 0.5.0 (pre_tool_call / post_tool_call)

Python standard library only in core/. No third-party Python dependencies.

This is a v1 candidate (1.0.0rc1). It is implemented and unit-tested locally. It is not production-ready, not yet device-accepted, and it makes no compliance claims.

| Implemented and unit-tested locally | yes ( Ran 719 tests ,OK , Python stdlib) | | Tested on the target Mac mini | no | | Google Gmail Developer Preview access | not granted yet | | Production | no | | Send mail, computer use, own agent loop | not included |

Start values for the call-limit window are assumptions in the Pilot 1 policy (3600 s; read 160, draft 40, internal_write 80) and will be reset after a pilot week from recorded gate_calls.

cd core
python3 -m unittest discover -s tests -q
python3 -m framework.cli version

version prints core_version, schema_version and ok as JSON. Further commands (python3 -m framework.cli <command>):

Command Arguments
verify-install package`` target [--package-hash ]
verify-plugin installed (--digest |--package )
plugin-digest dir
gate-serve --db``--socket``--principal [--server gmail] [--mode 0600] [--group ] [--unattended ]
gate-plist --label``--python``--workdir``--db``--socket``--principal``--user [--group ] [--server gmail] [--mode 0600] [--unattended ] [--log ]
verify-launchd installed``--package
verify-hooks home
verify-relay [ --home ] [--system-root /]
pin-audit source`` config
verify-hermes-dump dump_file``--package
verify-hermes-probe probe_file``--package
verify-device --package``--installed``--package-hash [--managed-dir /etc/hermes]--hermes-home``--plugin``--launchd``--dump [--home ] [--system-root /] [--profile ] [--allowed-profile ] [--audit-anchor ]
gate-init --db``--principal``--tenant [--package ] [--kind agent]
gate-audit --db``--tenant [--limit 50] [--summary ] [--since ] [--until ] [--anchor ]
gate-principal-add --db``--principal``--tenant``--role
gate-stop --db``--principal
gate-resume --db``--principal
gate-status --db``--tenant
gate-backup --db``--out
gate-restore --backup``--db [--expect-anchor ]
pilot-baseline --summary``--timesheet [--min-samples 5] [--require-clean ]
version —

Device installation, operation, backup and the acceptance probes are described in docs/v1/INSTALLATION-AND-OPERATIONS.md. That guide has not been executed on a device yet.

core/          Python core (stdlib), CLI, tests
adapters/      Runtime adapters (Hermes plugin: adapters/hermes/aaf-gate/)
templates/     Versioned industry templates
profiles/      Synthetic example profiles
docs/v0.4/     Product direction
docs/v0.5/     Notes on implemented increments
docs/v1/       Honest status and install/operations guide
docs/adr/      Architecture decisions
CHANGELOG.md
LICENSE        Apache-2.0

Copyright 2026 Konrad Kern. Licensed under the Apache License, Version 2.0. See LICENSE.

Hermes Agent is a separate project by Nous Research, licensed under MIT. This repository contains adapter and plugin code that talks to Hermes hooks; it does not vendor the Hermes source tree.

── more in #ai-agents 4 stories · sorted by recency
── more on @aaf-gate 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/show-hn-aaf-gate-pol…] indexed:0 read:3min 2026-11-22 · —