Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@

## 0.0.11-beta.0 — 2026-05-13

### Docs
- SEO fixes on the docs landing page (`docs/introduction.mdx`): replace the duplicate-brand title `Failproof AI` (which Mintlify rendered as `Failproof AI - FailproofAI`) with the keyword-bearing `Introduction — Failure Handling for AI Agents`, rewrite the 84-char generic meta description into a ~150-char one naming the 39 built-in policies + key failure modes (loops, secret leaks, destructive tool calls), seed the page body with the missing search keywords (`AI failure handling`, `error recovery`, `LLM reliability`) by reframing the lede, expand the CLI list to the actual 7-CLI surface, and correct the stale `26 built-in policies` card to the current `39`. Also corrects the same stale `26` count in `docs/architecture.mdx`'s Builtin policies section.
Comment thread
coderabbitai[bot] marked this conversation as resolved.
Outdated

### Fixes
- Dashboard `/policies` activity-tab subheading: replace the hardcoded "Policy evaluations for Claude" with a dynamic list of installed CLIs ("Policy evaluations across Claude Code, Cursor"), collapsing to "across N agents" when 4 or more are installed and falling back to "Policy evaluations" when none are. Reads from the existing `getHooksConfigAction()` payload — no new server work. The text was a leftover from when failproofai only supported Claude Code and was inaccurate against the now-7-CLI surface (Claude, Codex, Copilot, Cursor, OpenCode, Pi, Gemini) (#358).

Expand Down
2 changes: 1 addition & 1 deletion docs/architecture.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -186,7 +186,7 @@ After all policies run:

## Builtin policies

`src/hooks/builtin-policies.ts` defines all 26 built-in policies as `BuiltinPolicyDefinition` objects:
`src/hooks/builtin-policies.ts` defines all 39 built-in policies as `BuiltinPolicyDefinition` objects:
Comment thread
coderabbitai[bot] marked this conversation as resolved.

```typescript
interface BuiltinPolicyDefinition {
Expand Down
14 changes: 7 additions & 7 deletions docs/introduction.mdx
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
---
title: Failproof AI
description: "Manage hooks and policies that keep your AI agents reliable and running autonomously"
title: "Introduction — Failure Handling for AI Agents"
description: "FailproofAI gives AI agents 39 built-in failure policies — catching loops, secret leaks, destructive tool calls, and more. One install. Runs locally."
---

[![npm weekly downloads](https://img.shields.io/npm/dw/failproofai?style=flat-square&color=2ea44f)](https://www.npmjs.com/package/failproofai)

Hooks and policies that keep your AI agents reliable and running autonomously - for **Claude Code**, **OpenAI Codex**, and the **Agents SDK**.
Hooks and policies for **AI failure handling**, **error recovery**, and **LLM reliability** — keeping your AI agents reliable and running autonomously across **Claude Code**, **OpenAI Codex**, **GitHub Copilot**, **Cursor Agent**, **OpenCode**, **Pi**, **Gemini CLI**, and the **Agents SDK**.

AI agents fail in predictable ways. They run destructive commands, leak secrets, drift off-task, get stuck in loops, or push directly to main. Left unattended, small failures cascade.
AI agents fail in predictable ways. They run destructive commands, leak secrets, drift off-task, get stuck in loops, or push directly to main. Left unattended, small failures cascade into outages, leaked credentials, and lost work.

Failproof AI solves this with **policies** - rules that hook into every agent tool call and can **detect failures**, **mitigate them** (block, instruct, sanitize), and **alert you** when something needs attention. A local dashboard lets you review everything afterward.
FailproofAI solves this with **policies** — rules that hook into every agent tool call to **detect failures**, **mitigate them** (block, instruct, sanitize), and **alert you** when something needs attention. A local dashboard lets you review every tool call, agent failure, and recovery action afterward.

Everything runs locally. No data leaves your machine.

## Get started

<CardGroup cols={2}>

<Card title="26 built-in policies" icon="shield" href="/built-in-policies">
Block destructive commands, prevent secret leakage, keep agents inside project boundaries, and more - out of the box.
<Card title="39 built-in policies" icon="shield" href="/built-in-policies">
Block destructive commands, prevent secret leakage, keep agents inside project boundaries, and more — out of the box.
</Card>

<Card title="Custom policies" icon="code" href="/custom-policies">
Expand Down