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

​
前提条件

  • Node.js 18 以降
  • AI プロバイダーの API キー（Anthropic 推奨）

​
インストール

npx @refrainai/cli generate -- --help

​
AI プロバイダー設定

AI プロバイダーの API キーを設定します。デフォルトは Anthropic です： 
export ANTHROPIC_API_KEY="sk-ant-..."
Refrain は 7 つの AI プロバイダー（OpenAI、Google、Azure、Bedrock、Vertex、OpenAI 互換エンドポイント）に対応しています。全プロバイダーの設定手順と環境変数は AI プロバイダーを設定する を参照してください。

​
ステップ 1: コンテキストとシークレットを準備する

手順書を生成する前に、以下のファイルを必要に応じて用意します： context.md — 操作対象アプリの補足情報（ログイン URL、画面遷移のヒント、特殊な UI パターンなど）： 
# アプリ情報

- ログインページ: https://app.example.com/login
- ログイン後、ダッシュボードは /dashboard にある
- 「CSV エクスポート」ボタンは右上のツールバーにある
secrets.json — 必要に応じて認証情報や機密値を記述。全値が sensitive として扱われます： 
{
  "email": "[email protected]",
  "password": "s3cret!"
}

​
ステップ 2: 手順書を生成する

達成したいことを AI に伝えると、Web アプリを探索して手順書を構築します。 
npx @refrainai/cli generate -- \
  --url "https://app.example.com/login" \
  --goal "ログインしてダッシュボードに移動する" \
  --output ./login-flow.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --headless false \
  --model "claude-sonnet-4-6" \
  --model-provider anthropic
--headless false を指定すると、AI がアプリを探索する様子をリアルタイムで確認できます。省略するとヘッドレスモードで実行されます。
--model と --model-provider を毎回指定する代わりに、環境変数でデフォルトを設定できます。詳しくはデフォルトモデルの設定を参照してください。
AI は以下を行います：
  1. ブラウザを開いて URL に移動
  2. ページを探索し、実行するアクションを決定
  3. 各ステップ（クリック、入力、ナビゲーション）を記録
  4. ステップをレビューし、不要なものを除去
  5. クリーンな手順書を出力

​
ステップ 3: 手順書を実行する

生成された手順書を実行します： 
npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --headless false \
  --model "claude-sonnet-4-6" \
  --model-provider anthropic
セレクタは決定論的に解決されるため、再実行時に AI トークンは消費されません（フォールバック時は除く）。1 回でも 100 回でも、実行コストはゼロのままです。
  1. ブラウザを開いて開始 URL に移動
  2. 各ステップでセレクタを解決して対象要素を特定
  3. アクション（クリック、入力など）を実行
  4. 結果をレポート

​
ステップ 4: UI が変わったら自己修正

操作対象アプリの UI が変更されてステップが失敗するようになったら、--self-heal で AI に診断・修正提案を生成させます： 
npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --self-heal \
  --model "claude-sonnet-4-6" \
  --model-provider anthropic
自己修正モードでは、アグレッシブなリトライ戦略と AI による修正提案、診断レポートが有効になります。提案を確認したら、fix-runbook コマンドで適用します： 
npx @refrainai/cli fix-runbook -- \
  --runbook ./login-flow.yaml \
  --report ./login-flow-report.md
Web コンソールを使えば、手順書の生成・実行・スケジュール・自己修正を CLI なしでブラウザ上から行えます。

​
次のステップ

generate コマンド

手順書生成の全オプション。

execute コマンド

手順書実行の全オプション。

CLI 概要

利用可能な全コマンドを確認。

プラン

Pro、Team、Business で高度な機能をアンロック。