Skip to content

README.md

Latest commit

 

History

History
171 lines (131 loc) · 6.93 KB

README.md

File metadata and controls

171 lines (131 loc) · 6.93 KB
failproof ai

npm CI Slack Docs License

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

Runtime failure resolution for coding agents. Hooks into Claude Code and Codex. Catches loops, dangerous actions, and secret leaks before they become incidents. Zero latency. Runs locally.

Failproof AI in action

Supported agent CLIs

Claude Code        OpenAI Codex        GitHub Copilot        Cursor Agent

OpenCode        Pi        Gemini CLI

Install hooks for one or any combination: failproofai policies --install --cli opencode pi gemini (or --cli claude codex copilot cursor opencode pi gemini). Omit --cli to auto-detect installed CLIs and prompt. GitHub Copilot CLI, Cursor Agent, OpenCode, Pi, and Gemini CLI support are in beta — testing is ongoing.

Install

npm install -g failproofai
failproofai policies --install
failproofai

30 built-in policies activate immediately. Dashboard at localhost:8020.

What it stops

Policy What it blocks
block-push-master Direct pushes to main / master
block-force-push git push --force
block-work-on-main Commits, merges, rebases on main / master
block-rm-rf Recursive file deletion
sanitize-api-keys API keys leaking into agent context

→ All 30 built-in policies

Your own policies

Drop a file into .failproofai/policies/ — it loads automatically, no flags needed. Commit it and the whole team gets it on next pull.

import { customPolicies, deny, allow } from "failproofai";

customPolicies.add({
  name: "no-production-writes",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolInput?.file_path?.includes("production"))
      return deny("Writes to production paths are blocked.");
    return allow();
  },
});

Three decisions available to every policy:

Decision Effect
allow() Permit the operation
deny(message) Block it — message goes back to the agent
instruct(message) Let it through, but add context to the agent's next prompt

→ Custom policies guide

Session visibility

Every tool call your agent makes is logged locally. The dashboard shows what ran, what was blocked, and what the policy told the agent — so you're not guessing when something goes wrong. → Dashboard guide

Documentation
Getting Started Installation and first steps
Built-in Policies All 30 policies with parameters
Custom Policies Write your own
Configuration Config scopes and merge rules
Dashboard Session monitor and policy activity
Architecture How the hook system works

License

MIT with Commons Clause — free for internal and personal use; commercial resale of failproofai itself requires a separate agreement. See LICENSE for the full text.

Contributing

See CONTRIBUTING.md. New policies, edge cases, and translations all welcome.

Built by Nivedit Jain and Nikita Agarwal. befailproof.ai