Skip to main content
npm install -g failproofai でローカル CLI をインストールします。引数なしで実行するとローカルポリシーダッシュボードが開きます。 このパッケージには Node.js 20.9 以降が必要です。開発環境およびソースインストールには Bun 1.3 以降がサポートされています。failproofai configure と failproofai setup は failproofai config のエイリアスです。failproofai policy、failproofai pack、failproofai p はいずれも failproofai policies の別表記です — パックと個別ポリシーはもともと 3 つのコマンドに分かれていましたが、1 つの概念として統合されました。古い表記も引き続き使用できますが、例外が 2 つあります: pack list <source> は policies show <source> に、pack build は publish に変更されました。

​
マシンのセットアップ

CLI をインストールし、マシンキーをシェルに読み込みます。read -s を使うとコマンドに表示されずにプロンプトで入力できるため、履歴に残りません:
次に、マシンをセットアップして適用するポリシーを選択します:
failproofai config はセットアップのすべてを担います: failproofaid サービスのインストール（ルート権限で一度だけ、sudo -n 経由 — 対話的なパスワードプロンプトは表示されません）、見つかったすべてのエージェント CLI へのフックの接続、キーが有効な場合の Cloud への接続を行います。ターミナルがない環境（CI、コンテナ、エージェントが操作している場合など）では、対話なしで設定を適用し、指定された操作が完了しない場合は終了コード 1 で終了します。 ポリシーは何も選択されません。それは 2 番目のコマンドの役割であり、これがなければ新しく設定されたマシンは常時オンのガードのみを適用します。 --token よりも環境変数を推奨します: コマンドライン引数はシステム上のすべてのユーザーが ps で読み取れるためです。ただし、環境変数が保護するのはその点のみです — export を含め、コマンドに直接キーを入力するとシェル履歴に残るため、上記のように read -s で読み込んでいます。CI では、シェルトレーシング（set -x）をオフにした状態でシークレットストアから設定してください。オンにするとトレースに出力されてしまいます。
--connect <url> はすでにセットアップ済みのマシンを登録します。登録が成功するとすぐに返り、デーモンのインストールやフックの接続は行いません。まだセットアップされていないマシンには failproofai config（または failproofai config --token <key>）を使用してください。そうしないと、接続済みと表示されながら何も収集・適用されない状態になります。
引数なしで failproofai を実行するとローカルポリシーダッシュボードが開きます。

​
設定フラグ

ローカルの一時停止は、組み込み、カスタム、規約、パックのポリシーを 1 セッションの間だけ停止します。一時停止は必ず期限切れになり、Cloud 管理のポリシーは無効化されません。block-failproofai-commands は常時オンで無効化も一時停止もできず、インストゥルメント済みエージェントがこの回避策を使うことを防ぎます。

​
ポリシーフラグ

​
配信とメンテナンスフラグ

failproofai update は npm install -g failproofai@latest の後に実行してください。ホームレイアウトのマイグレーション、対応するデーモンバイナリのインストール、サービスの再起動を行います。--no-daemon はレイアウトマイグレーションのみを実行します。

​
ハーネスパス

サポートされているハーネス名は claude、codex、copilot、cursor、opencode、pi、hermes、openclaw、factory、devin、antigravity、goose です。 ラベルは、2 つのルートが同じプロジェクトのコピーを含む場合に、派生エージェント ID を名前空間で区別します。重複するルートと重複するラベルは、収集の重複やカーソルの破損を防ぐために拒否されます。追加パスの設定はデーモンの再起動なしにリロードされます。 コンテナ環境では、ファイルで設定された追加パスをカンマ区切りの変数 FAILPROOFAI_<HARNESS>_EXTRA_PATHS で置き換えることができます。例:

​
環境変数

永続的なマシン動作には設定ファイルを使用してください。環境変数はコンテナ、テスト、単一プロセスに最も適しています。 CLAUDE_PROJECTS_PATH、CURSOR_HOME、HERMES_HOME、OPENCLAW_HOME などのエージェント固有のホーム変数は、Failproof AI がそのハーネスのローカルセッションを検出する場所を上書きします。

​
マシンを安全に一時停止または削除する

ローカルセッションの一時停止は Cloud 管理のポリシーを無効化しません。ロールアウト自体が問題の場合は、Cloud の適用ワークフローを通じて Cloud のデプロイを復元してください。 npm パッケージを削除する前に、インストール済みのフックとデーモンを削除してください:
バージョン固有の詳細は failproofai <command> --help で確認してください。
npm rm -g failproofai の前に failproofai uninstall を実行してください。npm はインストール済みのエージェントフックやデーモンサービスを削除しません。