> ## Documentation Index > Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt > Use this file to discover all available pages before exploring further. # Failproof AI CLI > フックのインストール、ローカルポリシーの管理、Cloudへの接続、ローカルデーモンの操作。 `npm install -g failproofai` でローカル CLI をインストールします。引数なしで実行すると、ローカルポリシーダッシュボードが開きます。 このパッケージには Node.js 20.9 以降が必要です。Bun 1.3 以降は開発およびソースインストールに対応しています。`failproofai configure` と `failproofai setup` は `failproofai config` のエイリアスです。`failproofai p` は `failproofai policies` のエイリアスです。 ## マシンのセットアップ ```bash theme={null} npm install -g failproofai failproofai config \ --connect https://app.befailproof.ai \ --token \ --machine-label checkout-prod-01 failproofai policies --install failproofai config --status ``` 引数なしで `failproofai` を実行すると、ローカルポリシーダッシュボードが開きます。 | コマンド | 内容 | | ------------------------------------------------------- | ---------------------------------------------- | | `failproofai config` | マシンのインタラクティブセットアップを実行する | | `failproofai config --connect --token ` | Cloud のイベント取り込みとポリシー配信を接続する | | `failproofai config --status` | 接続状況、デーモン、配信、一時停止の状態を表示する | | `failproofai policies` | 組み込みポリシーとカスタムポリシーを一覧表示する | | `failproofai policies --install` | フックをインストールしてポリシーを有効にする | | `failproofai policy add ` | 組み込みポリシーを1つ有効にする | | `failproofai policy remove ` | 組み込みポリシーを1つ無効にする | | `failproofai policies --uninstall` | ポリシーを無効にするか、ハーネスフックを削除する | | `failproofai audit` | ローカルエージェントの履歴をスキャンし、ローカル監査ビューを開く | | `failproofai audit --schedule [days] --email
` | 定期的なローカルスキャンをスケジュールし、結果をメール送信する | | `failproofai audit --status` | レポートの送信先アドレス、間隔、次回スキャン予定を表示する | | `failproofai audit --no-schedule` | 監査履歴を削除せずに定期スキャンを停止する | | `failproofai harness list` | 追加のキャプチャパスを一覧表示する | | `failproofai flush --wait` | 現在のイベントスプールを配信する | | `failproofai backfill --since 30d` | 過去に通過した履歴を再読み込みする | | `failproofai config --pause [duration]` | ローカルセッションを一時停止する（デフォルト30分、最大8時間） | | `failproofai config --resume` | 一時停止中のローカルセッションを再開する。`--all` を付けると全ての一時停止を解除する | | `failproofai update` | パッケージのマイグレーションを完了し、デーモンを更新する | | `failproofai migrate --dry-run` | ホームレイアウトの保留中マイグレーションをプレビューまたは実行する | | `failproofai uninstall` | パッケージを削除する前にフックとデーモンを削除する | | `failproofai --version` | インストール済みパッケージのバージョンを表示する | | `failproofai --help` | コマンドとグローバルな使い方を表示する | ## 設定フラグ | フラグ | 用途 | | ------------------------------- | ------------------------------------------------ | | `--connect --token ` | 非インタラクティブモードで接続する | | `--machine-id ` | 固定マシン ID を設定する | | `--machine-label ` | ダッシュボードのラベルを設定または変更する | | `--no-transcripts` | トランスクリプトの内容を含めずに判断結果のみ送信する | | `--disconnect` | Cloud からのポリシー取得とイベント配信を停止する | | `--status` | 現在のマシン状態を表示する | | `--pause [duration]` | カレントディレクトリの最新セッションを一時停止する。秒・分・時間を指定可能で、デフォルトは30分 | | `--resume` | 一致する一時停止を早期に終了する | | `--session ` | 一時停止または再開の対象セッションを明示的に指定する | | `--all` | `--resume` と組み合わせて、全てのアクティブな一時停止を終了する | ローカルの一時停止は、1つのセッションについて組み込みポリシー・カスタムポリシー・規約ポリシーを停止します。常に有効期限があり、Cloud 管理ポリシーは無効化しません。`block-self-pause` は、計装済みエージェントがこのエスケープハッチを自ら使用することを防ぎます。 ## ポリシーフラグ | フラグ | 用途 | | ----------------------------------- | ------------------------------- | | `--install`, `-i` | ポリシーを有効にし、ハーネスフックをインストールする | | `--uninstall`, `-u` | ポリシーを無効にするか、フックを削除する | | `--cli ` | 対象とするハーネスを1つ以上指定する | | `--scope user\|project\|local\|all` | 設定スコープを選択する。`all` はアンインストール用 | | `--beta` | ベータポリシーを含める | | `--custom`, `-c ` | カスタムポリシーファイルを検証して読み込む（繰り返し指定可能） | ## 配信・メンテナンスフラグ | コマンド | フラグ | | ----------- | -------------------------------------------- | | `backfill` | `--since <30d\|6m\|YYYY-MM-DD>`, `--dry-run` | | `flush` | `--wait`, `--timeout ` | | `update` | `--no-daemon` | | `migrate` | `--dry-run` | | `uninstall` | `--purge`, `--dry-run`, `--yes` | `failproofai update` は `npm install -g failproofai@latest` の後に実行してください。ホームレイアウトのマイグレーション、対応するデーモンバイナリのインストール、サービスの再起動を行います。`--no-daemon` を指定するとレイアウトマイグレーションのみが実行されます。 ## ハーネスパス ```text theme={null} failproofai harness list [harness] failproofai harness add-path [label=] failproofai harness remove-path ``` サポートされているハーネス名は `claude`、`codex`、`copilot`、`cursor`、`opencode`、`pi`、`hermes`、`openclaw`、`factory`、`devin`、`antigravity`、`goose` です。 ラベルは、2つのルートに同じプロジェクトのコピーが存在する場合に、派生エージェント ID を名前空間で区別します。重複するルートや重複するラベルは、二重収集やカーソルの破損を防ぐために拒否されます。追加パスの設定はデーモンを再起動せずにリロードされます。 コンテナ環境では、ファイルで設定した追加パスをカンマ区切りの変数 `FAILPROOFAI__EXTRA_PATHS` で置き換えられます。例： ```bash theme={null} export FAILPROOFAI_OPENCLAW_EXTRA_PATHS="user1=/srv/openclaw-a,user2=/srv/openclaw-b" ``` ## 環境変数 永続的なマシン動作には設定ファイルを使用してください。環境変数はコンテナ、テスト、単一プロセスに最も適しています。 | 変数 | 用途 | | ------------------------------------ | ------------------------------------ | | `FAILPROOFAI_HOME` | `~/.failproofai` のレイアウト全体を移動する | | `FAILPROOFAI_LOG_LEVEL` | ローカルのログ出力レベルを設定する | | `FAILPROOFAI_HOOK_LOG_FILE` | フックの診断情報を指定ファイルに書き出す | | `FAILPROOFAI_TELEMETRY_DISABLED=1` | このプロセスの匿名テレメトリを無効にする | | `FAILPROOFAI_NO_FIRST_RUN=1` | インタラクティブな初回セットアップをスキップする | | `FAILPROOFAI_NO_AUTO_AUDIT=1` | セットアップ後のローカル監査をスキップする | | `FAILPROOFAI_LLM_BASE_URL` | LLM ポリシーが使用する OpenAI 互換エンドポイントを上書きする | | `FAILPROOFAI_LLM_API_KEY` | LLM ポリシーが使用する API キーを設定する | | `FAILPROOFAI_LLM_MODEL` | LLM ポリシーが使用するモデルを選択する | | `FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS` | カスタムポリシーモジュールの読み込みにタイムアウトを設定する | | `FAILPROOFAI__EXTRA_PATHS` | 特定のハーネスの追加キャプチャパス設定を上書きする | | `NO_COLOR` | ターミナルのカラー出力を無効にする | `CLAUDE_PROJECTS_PATH`、`CURSOR_HOME`、`HERMES_HOME`、`OPENCLAW_HOME` などのエージェント固有のホーム変数は、Failproof AI が各ハーネスのローカルセッションを検出する場所を上書きします。 ## マシンの安全な一時停止と削除 ```bash theme={null} failproofai config --pause failproofai config --status failproofai config --resume ``` ローカルセッションの一時停止は、Cloud 管理ポリシーを無効化しません。ロールアウト自体が問題の場合は、Cloud の強制適用ワークフローを通じて Cloud デプロイメントを復元してください。 npm パッケージを削除する前に、インストール済みのフックとデーモンを削除してください： ```bash theme={null} failproofai uninstall --dry-run failproofai uninstall --yes npm rm -g failproofai ``` バージョン固有の詳細については `failproofai --help` を実行してください。 `npm rm -g failproofai` の前に `failproofai uninstall` を実行してください。npm はインストール済みのエージェントフックやデーモンサービスを削除しません。