Quickstart - Failproof AI

This quickstart gets one machine reporting sessions, runs an audit, and deploys a policy. Use the skill to set Failproof up, or follow the manual steps. You need Node.js 20.9 or later.

Use the skill
Manual setup

Install the Failproof AI skills

npx skills add FailproofAI/skills

Ask your agent to set everything up

Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.

Your agent inspects the project, chooses the relevant integration, performs the setup, and verifies it. See the FailproofAI skills repository for individual skills and advanced installation options.

Before you start

Open the Failproof AI dashboard and create an account or sign in with your work email.
Go to Administration → Keys and create a key with events:add and policies:pull.
Copy the one-time secret and store it on the target machine:

export FAILPROOFAI_KEY="<one-time-secret>"

Install

Install and connect Failproof AI

npm install -g failproofai
failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY"

Session transcripts are sent by default. Add --no-transcripts to report hook activity and policy decisions without transcript content.If this machine already has agent history, preview and import the last seven days, then wait for delivery to finish. Skip this step on a new machine.

failproofai backfill --since 7d --dry-run
failproofai backfill --since 7d
failproofai flush --wait

Open Sessions in Failproof AI and select an imported session.

Install agent hooks and policies

This attaches Failproof AI to your agent CLI and installs the built-in policies. Use them to see local policy decisions and try enforcement before Failproof AI audits your sessions and writes policies for your agents.Let the installer detect your agent CLI, or name one explicitly.

failproofai policies --install --cli claude --scope user

Audit the behavior

Follow Run your first failure check. Use a concrete goal such as “find sessions where the agent retried a failing tool without changing its approach.”

Prevent the failure

Follow Prevent your first failure with a policy. Start in observe mode, inspect matches, then enforce the reviewed version.

Run failproofai config --status. A healthy setup reports the cloud connection, daemon state, and whether enforcement is paused.

​Before you start

​Install

Before you start

Install