failproofai

Name: failproofai
Author: FailproofAI

Verified

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

130stars

22forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/FailproofAI/failproofai

Getting Started

Guides for using ai agents skills like failproofai.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-30T17:00:43.013Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is failproofai?

failproofai is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by FailproofAI. Runtime failure resolution for coding agents. Hooks into Claude Code, Codex & your favourite harnesses. Catches loops, dangerous actions, and secret leaks before they become incidents. Zero latency. Runs locally. It has 130 GitHub stars.

Is failproofai safe to use?

Yes. failproofai passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install failproofai?

Clone the repository with "git clone https://github.com/FailproofAI/failproofai" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is failproofai written in?

failproofai is primarily written in TypeScript. It is open-source under FailproofAI on GitHub, so you can review or fork the full source.

Are there alternatives to failproofai?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh failproofai against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

clarilayer kogiqa-mcp

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.

Supported agent CLIs

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.

Install

npm install -g failproofai
failproofai policies --install   # or just run `failproofai` and accept the first-run prompt
failproofai

30 built-in policies activate immediately. Dashboard at localhost:8020. Disable the first-run prompt with FAILPROOFAI_NO_FIRST_RUN=1.

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.

Build before you start. Run bun install && bun run build first. This repo runs failproofai's own hooks on itself, and they resolve the failproofai import against the compiled dist/ bundle — without a build you'll hit Cannot find package 'failproofai' hook errors. Rebuild after changing src/. See Build before the in-repo dev hooks will work.

Built by Nivedit Jain and Nikita Agarwal. befailproof.ai