Claude Code usage

Failproofai

Observability and enforcement for AI agent harnesses. Capture every run and runtime reliability with policy enforcement.

7,772 stars 558 forksUsage & cost trackers Source

Install

Install
npm install -g failproofai

Found in the project README. Check it for setup steps after installing.

From source
git clone https://github.com/FailproofAI/failproofai.git

From the README

Translations: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית

Observability and enforcement for every harness your agents run in.
Wherever your agents run, we see it — and we can say no. Failproof hooks 12 agent
harnesses — coding CLIs like Claude Code and Codex, chat gateways like Hermes,
self-hosted assistants like OpenClaw — capturing every run and blocking dangerous
tool calls before they execute. 40 built-in policies. Zero latency. Runs locally.

Supported harnesses

Twelve harnesses in two classes — ten coding CLIs, and two chat and assistant
gateways (Hermes, OpenClaw). One policy API and one session history across all
of them. What a policy can *block* is per-harness: stopping a tool call before
it runs is verified on all twelve, turn-end gates on eight. The
per-harness matrix
lists the events each one honours.

Agents that run in none of them report through the Python SDK,
which gives you tracing, sessions and audits. Enforcement there needs a hook in
your own runtime — talk to us and we'll map it.

Install

Setup wires the hooks and picks no policies — that second command is what
puts guardrails on the machine, and any pack is typed the same way
(failproofai policies add /; policies show / reads
one first). Run failproofai config with no terminal — CI, a container, an
agent driving it — and it applies rather than asking. On a machine that has
never been set up, any other command runs the same wizard first; disable that
with FAILPROOFAI_NO_FIRST_RUN=1.

Until a pack arrives, the only thing enforcing is block-failproofai-commands,
which is always on and cannot be switched off or paused: an agent that can pause
enforcement can switch off every other policy.

What it stops

Every…
Read the full README on GitHub

Details

Language
TypeScript
Last updated
3 November 2026
Topics
agent-failureagent-harnessagent-observabilityagent-reliabilityagent-tracingai-agentclaude-codecodexenforcementevalsguardrailshermes

FAQ

What is Failproofai?

Observability and enforcement for AI agent harnesses. Capture every run and runtime reliability with policy enforcement. It is a usage for Claude Code, from FailproofAI/failproofai on GitHub.

How do I install Failproofai?

Run npm install -g failproofai, then follow the setup in the README.

Is Failproofai popular?

FailproofAI/failproofai has 7,772 GitHub stars and 558 forks, and is included in 1 curated Claude Code list. It was last updated on 3 November 2026.

More usage & cost trackers

Browse the most popular Claude Code mods, all usage & cost trackers, or the skills and MCP server directories.