クイックスタート

このクイックスタートでは、1台のマシンでセッションのレポートを開始し、監査を実行して、ポリシーをデプロイします。スキルを使って Failproof をセットアップするか、手動の手順に従ってください。 どちらの方法を選びますか？ エージェントが12種類のサポートされたハーネス（コーディング CLI、または Hermes や OpenClaw などのゲートウェイ）で動作している場合は、以下の手順に従ってください。Node.js 20.9 以降が必要です。エージェントにハーネスがない場合は、Python SDK を使ってトレースと監査のインストルメンテーションを行い、最初の障害チェックを実行するから再合流してください。このパスでの強制実行には、ランタイムにフックが必要です。

スキルを使用する
手動セットアップ

Failproof AI スキルをインストールする

npx skills add FailproofAI/skills

エージェントにすべてのセットアップを依頼する

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

エージェントがプロジェクトを検査し、適切なインテグレーションを選択してセットアップを実行し、検証します。個別のスキルや高度なインストールオプションについては、FailproofAI skills リポジトリを参照してください。

開始前の準備

Failproof AI ダッシュボードを開き、アカウントを作成するか、仕事用メールアドレスでサインインします。
Administration → Keys に移動し、events:add と policies:pull のキーを作成します。
ワンタイムシークレットをコピーして、対象マシンに保存します。

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

インストール

Failproof AI をインストールして接続する

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

セッションのトランスクリプトはデフォルトで送信されます。トランスクリプトの内容を含めずにフックアクティビティとポリシー決定のみをレポートするには、--no-transcripts を追加してください。このマシンにすでにエージェントの履歴がある場合は、過去7日間のデータをプレビューしてインポートし、配信が完了するまで待ちます。新しいマシンではこの手順をスキップしてください。

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

Failproof AI の Sessions を開き、インポートしたセッションを選択します。

エージェントフックとポリシーをインストールする

これにより Failproof AI がハーネスにアタッチされ、39個の組み込みポリシーがインストールされます。Failproof AI がセッションを監査してエージェント用のポリシーを作成する前に、ローカルのポリシー決定を確認したり、強制実行を試したりするために使用できます。インストーラーにハーネスを自動検出させるか、明示的に指定してください。12種類すべてが有効な --cli の値です — claude、codex、copilot、cursor、opencode、pi、hermes、openclaw、factory、devin、antigravity、goose。

failproofai policies --install --cli claude --scope user     # コーディング CLI
failproofai policies --install --cli hermes --scope user     # Slack/Telegram ゲートウェイ

実行前のツール呼び出しのブロックは全12種類で検証済みです。ターン終了ゲートは8種類で検証済みです — ハーネスごとの対応状況は強制実行の対応状況を参照してください。

動作を監査する

最初の障害チェックを実行するに従ってください。「エージェントがアプローチを変えずに失敗したツールを再試行したセッションを見つける」など、具体的な目標を使用してください。

障害を防止する

ポリシーで最初の障害を防止するに従ってください。オブザーブモードで開始し、マッチを確認してから、レビュー済みのバージョンを強制適用してください。

failproofai config --status を実行してください。正常なセットアップでは、クラウド接続、デーモンの状態、および強制実行が一時停止されているかどうかが報告されます。

​開始前の準備

​インストール

開始前の準備

インストール