概要
npx @refrainai/cli generate -- \
--url <url> \
--goal <goal> \
--output <path> \
[options]
必須引数
| 引数 | 説明 |
|---|---|
--url <url> | 探索を開始する URL |
--goal <goal> | 達成するゴール（自然言語で記述） |
--output <path> | 生成する手順書の出力パス |
オプション引数
探索設定
| 引数 | デフォルト | 説明 |
|---|---|---|
--max-iterations <num> | 20 | 最大探索ループ回数 |
--step-delay <ms> | 500 | ステップ間の待機時間（ミリ秒） |
--headless <bool> | true | false でブラウザウィンドウを表示 |
コンテキスト・シークレット
| 引数 | デフォルト | 説明 |
|---|---|---|
--context <path> | - | 補足情報マークダウンファイルのパス |
--secrets <path> | - | secrets JSON ファイルのパス（{"key": "value"} 形式、全値 sensitive） |
出力・デバッグ
| 引数 | デフォルト | 説明 |
|---|---|---|
--screenshots <dir> | - | スクリーンショット保存ディレクトリ |
--video <dir> | - | 動画録画の出力先ディレクトリ |
AI モデル
| 引数 | デフォルト | 説明 |
|---|---|---|
--model <id> | claude-sonnet-4-6 | AI モデル ID |
--model-provider <provider> | anthropic | AI プロバイダー: anthropic, openai, openai-compatible, google, azure, bedrock, vertex |
--model-base-url <url> | - | OpenAI 互換エンドポイントのベース URL |
詳細設定
| 引数 | デフォルト | 説明 |
|---|---|---|
--locale <code> | en | UI・AI プロンプトの言語: en または ja |
--stealth | false | ステルスモード（bot 検出回避パッチ適用） |
--proxy <url> | - | プロキシ URL（例: http://user:pass@host:port） |
--skill <names> | - | スキルプラグイン名（カンマ区切り、例: google-sheets） |
--stealth と --proxy は Pro プラン以上が必要です。--skill は Pro プラン以上が必要です。使用例
基本的な生成
npx @refrainai/cli generate -- \
--url "https://app.example.com/login" \
--goal "メールアドレスとパスワードでログインし、設定ページに移動する" \
--output ./login-settings.yaml \
--context ./context.md \
--secrets ./secrets.json \
--model "claude-sonnet-4-6" \
--model-provider anthropic
環境変数でデフォルトモデル・プロバイダーを設定すれば、毎回指定する必要がなくなります。詳しくはデフォルトモデルの設定を参照してください。
ブラウザを表示して生成
npx @refrainai/cli generate -- \
--url "https://staging.example.com" \
--goal "「テストプロジェクト」という新しいプロジェクトを作成する" \
--output ./create-project.yaml \
--headless false
コンテキストファイル付き
アプリの理解を助ける追加コンテキストを提供：npx @refrainai/cli generate -- \
--url "https://app.example.com" \
--goal "月次レポートを CSV でエクスポートする" \
--output ./export-report.yaml \
--context ./app-guide.md
シークレット付き
npx @refrainai/cli generate -- \
--url "https://app.example.com/login" \
--goal "ログインしてダッシュボードを表示する" \
--output ./login.yaml \
--secrets ./secrets.json
secrets.json の内容：
{
"email": "[email protected]",
"password": "s3cret!"
}
OpenAI を使用
export OPENAI_API_KEY="sk-..."
npx @refrainai/cli generate -- \
--url "https://app.example.com" \
--goal "お問い合わせフォームに入力する" \
--output ./contact-form.yaml \
--model "gpt-4o" \
--model-provider openai
スクリーンショットと動画付き
npx @refrainai/cli generate -- \
--url "https://app.example.com" \
--goal "オンボーディングフローを完了する" \
--output ./onboarding.yaml \
--screenshots ./screenshots \
--video ./videos
環境変数
| 変数 | 説明 |
|---|---|
AI_MODEL_ID | --model のデフォルト値 |
AI_MODEL_PROVIDER | --model-provider のデフォルト値 |
REFRAIN_LOCALE | --locale のデフォルト値（en または ja） |