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

インストール

npm install -g @refrainai/cli

コマンド一覧

コマンド説明
generateAI によるブラウザ探索で手順書を生成
execute手順書を実行
fix-runbook実行レポートの修正提案を手順書に適用
compose複数の手順書を1つの分岐付き手順書にマージ
runnerリモートブラウザ Runner を起動
serveリモート実行と Web コンソール用 API サーバーを起動

グローバルオプション

オプション説明
--version, -vバージョンを表示
--help, -hヘルプを表示

基本的な使い方

手順書を生成する

npx @refrainai/cli generate -- \
  --url "https://app.example.com/login" \
  --goal "ログインしてダッシュボードデータをエクスポートする" \
  --output ./login-export.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --headless false \
  --model "claude-sonnet-4-6" \
  --model-provider anthropic
環境変数でデフォルトモデル・プロバイダーを設定すれば、毎回指定する必要がなくなります。詳しくはデフォルトモデルの設定を参照してください。

手順書を実行する

npx @refrainai/cli execute -- \
  --runbook ./login-export.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --headless false \
  --model "claude-sonnet-4-6" \
  --model-provider anthropic

自動修正モード

アグレッシブなリトライと AI 修正提案で手順書を検証:
npx @refrainai/cli execute -- \
  --runbook ./login-export.yaml \
  --self-heal

修正を適用する

AI が生成した修正提案を適用して壊れた手順書を更新:
npx @refrainai/cli fix-runbook -- \
  --runbook ./login-export.yaml \
  --report ./report.md

AI プロバイダー設定

デフォルトでは Anthropic Claude を使用します。API キーを設定してください:
export ANTHROPIC_API_KEY="sk-ant-..."
他のプロバイダー(OpenAI、Google、Azure、Bedrock、Vertex)については AI プロバイダーを設定する で必要な環境変数とフラグを確認してください。

API キー(プランティア)

API キーを設定して高度な機能をアンロック:
export REFRAIN_API_KEY="rfn-eyJ..."
またはコマンドごとに指定:
npx @refrainai/cli execute -- --runbook ./flow.yaml --api-key "rfn-eyJ..."
詳しくはプラン・料金を参照してください。