- Coding CLIs (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose
- Chat and assistant gateways (2) — Hermes (Slack, Telegram, cron), OpenClaw (self-hosted assistant)
Each integration normalizes its native hook event names, tool names, and tool-input fields before policies run. A policy can only act on events the harness exposes; test end-of-turn and instruction behavior on the exact harness and version you deploy.
Enforcement capability
“Block” means the current adapter’s returned verdict is consumed by the named harness. Post-tool blocking may replace the result shown to the model but cannot undo a tool side effect that already happened.
Capabilities are version-sensitive. Re-test after upgrading an agent CLI, especially when a policy relies on prompt, stop, permission, or post-tool behavior rather than the common pre-tool gate.
Hermes native plugin
Hermes is integrated through a profile-local native plugin rather than a shell command. Installation links every default and named Hermes profile’splugins/failproofai to the plugin shipped in the npm package (a copy where a
symlink cannot be created), enables it in that profile’s config.yaml, and
migrates only legacy FailproofAI shell-hook entries. Because the plugin is
linked, npm install -g failproofai@latest updates it with no reinstall. This
avoids a process spawn on each hook. The plugin supports Hermes 0.20.0 and
later.
Legacy shell hooks (installed by 1.0.5 and earlier) do not check Hermes
cron jobs: each cron run builds its own hook scope, which the native plugin
joins and config.yaml shell hooks do not. failproofai update migrates every
profile that already uses FailproofAI to the linked plugin. If the running
daemon cannot serve the plugin, update leaves the shell hooks in place and
exits non-zero; run failproofai config to update the daemon, then
failproofai update again. Cron jobs load the plugin on their next run; restart
running gateways and interactive sessions to load it there.
On Hermes, deny() blocks the call and instruct() does not: the call runs,
and the guidance is placed at the start of its result — as the first key,
failproof_policy_reminder, of a JSON result, or as a leading
[FailproofAI policy reminder (...)] line — so the model reads it with the
output, and scripts that parse the result keep working. A policy’s reminder is
shown once per turn, and kept short on a large result. Use deny() when an
action must not happen at all: instruct() no longer stops the action first.
Tool calls made from an execute_code script put their reminder on the
execute_code result the model reads; the script’s own copy of the result is
left untouched. The model is told never to quote a reminder in its replies.
A Hermes build without plugin middleware falls back to holding the matching
call once with “FailproofAI policy guidance”; the next model response may
repeat it, or do the same work with another tool, without being held again.
Tool names are matched across Hermes versions: process_manage,
cronjob_manage, and todo_list (Hermes 0.21) are treated like process,
cronjob, and todo (Hermes 0.20). Each time Hermes loads the plugin it writes
heartbeat.json in the profile’s
plugin-data/agent-plugin-failproofai-5296f299/ directory, recording the
Hermes version, the plugin’s path and version, and the hooks Hermes accepted.
Run failproofai config --status to detect a disabled, incomplete, duplicated,
or newly unconfigured profile, or one still on legacy shell hooks (reported as
“Hermes cron jobs are not checked”).
OpenClaw plugin
OpenClaw loads FailproofAI as an in-process gateway plugin, registered in every profile’sopenclaw.json. Like the Hermes plugin, it asks the local
failproofaid daemon for each verdict over its socket, so it needs a running
daemon: installation refuses without one, and if the daemon cannot answer, tool
calls and prompts are blocked and the reason is written to the gateway log.
After npm install -g failproofai@latest, restart the OpenClaw gateway so it
loads the updated plugin.
Codex hook trust
Codex 0.129 and later runs a hook from~/.codex/hooks.json only after you approve it in interactive codex (“Review hooks”); until then, every Codex session — headless codex exec included — skips it. Hooks in Codex’s system config, /etc/codex/config.toml on Linux and macOS, run without that approval.
So when failproofai config (or policies --install --cli codex at user scope) can use sudo, it writes the Codex hooks into /etc/codex/config.toml, between # >>> failproofai managed hooks >>> and # <<< failproofai managed hooks <<<, and leaves the rest of that file as it was. The file applies to every account on the machine. failproofai uninstall and unticking Codex in failproofai config take the block out again.
Without sudo, and on Windows, the hooks stay in ~/.codex/hooks.json. failproofai config and failproofai config --status then do not count Codex as enforcing until the hooks are approved, and say how to fix it: re-run failproofai config and allow sudo, or open codex once and approve the hooks.
Install capture and policy hooks
- Dashboard
- CLI
- Open Administration → Keys and create a key with
events:addandpolicies:pull, named for the machine or environment. - On the target machine, connect the local CLI with the displayed key and install the harness hooks.
- Start a new agent session, then confirm its hook and session events under Observe → Events.
- Open Observe → policy for the same time window and confirm a policy decision is attributed to the machine.



Add a non-default session path
- Dashboard
- CLI
Extra paths are registered on the machine, not in Cloud. After adding one, open Observe → Sessions, filter to the machine’s environment, and confirm sessions from the new path appear. Open a session and check the agent, harness, and event timestamps before relying on it in an audit.


