メインコンテンツへスキップ

​
概要

execute コマンドは手順書を読み込み、各ステップをブラウザで再生します。セレクタは決定論的に解決されるため、再実行時に AI トークンは消費されません（フォールバック時は除く）。1 回でも 100 回でも、実行コストはゼロのままです。

​
前提条件

  • 生成済みの手順書（手順書を生成するを参照）
  • AI プロバイダーの API キー（フォールバック機能使用時のみ必要）
  • コンテキストファイル（手順書が context 変数を使用する場合）

​
基本的な実行

1

execute コマンドを実行

npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --headless false
エグゼキュータの動作：
  1. 手順書を読み込み、すべての変数を解決
  2. ブラウザを開いて開始 URL に移動
  3. 多層的なセレクタ解決を使って各ステップを実行
  4. 各ステップの結果をレポート
2

変数値を入力

source: prompt の変数は CLI で対話入力を求めます。それ以外のソース（fixed、env、context、secrets）の変数は自動的に解決されます。
3

結果を確認

実行後、各ステップのステータス（成功、失敗、スキップ）を表示するサマリーが出力されます。--report で詳細な Markdown レポートを生成できます。

​
詳細オプション

​
スクリーンショット

デバッグや監査のために、各ステップ後にスクリーンショットを保存します： 
npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --screenshots ./screenshots

​
動画撮影

実行全体を動画として記録します： 
npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --video ./recordings
動画撮影には Business 以上のプランが必要です。

​
ダウンロードとエクスポート

ダウンロード・エクスポートファイルを特定のディレクトリに保存します： 
npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --output-dir ./output \
  --merge-downloads
--merge-downloads は複数のダウンロード CSV ファイルを 1 つに結合します。

​
承認ワークフロー

requiresConfirmation: true が設定されたステップでは実行が一時停止し、承認を待ちます。デフォルトでは CLI で承認を処理します。チームワークフローでは Slack、Teams、Discord を使用できます。 設定の詳細は承認と通知を参照してください。

​
ステップ遅延

ステップ間の待機時間を制御します（手順書の pauseBetweenSteps 設定を上書き）： 
npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --step-delay 1000

​
実行が失敗した場合

UI の変更によりステップが失敗した場合、いくつかの選択肢があります：
  1. 自動修復モード — AI に診断と修正提案をさせる：--self-heal（自動修復ガイドを参照）
  2. ビジュアルデバッグ — --headless false で失敗箇所を目視確認
  3. スクリーンショット確認 — --screenshots で各ステップのページ状態をキャプチャ
  4. レポート確認 — --report で詳細な診断情報を出力

​
次のステップ

自動修復モード

失敗を自動的に診断・修正。

変数とシークレット

変数で手順書をパラメータ化。

承認と通知

Slack/Teams/Discord 承認の設定。

execute CLI リファレンス

execute コマンドの全オプション。