クイックスタート & CLI
stepperを使い始め、CLIのコマンド、フラグ、モードを参照します。
数分でstepperを起動して使い始められます。CLIはエージェントを使う3つの方法を提供します。対話型のTUI、ヘッドレスのワンショットプロンプト、または以前のセッションの再開です。それぞれに固有のコマンドとフラグがあります。
クイックサンプル
以下のサンプルは、stepperを呼び出す最も一般的な方法を示しています。
sh
# Interactive TUI (needs a real terminal + an API key in the env):
STEPPER_ANTHROPIC_API_KEY=sk-... stepper --model anthropic/claude-sonnet-4
# Headless one-shot (streams assistant text to stdout, auto-approves actions):
stepper -p "add a README badge" --model ollama-cloud/qwen3-coder --mode auto
# Resume a previous session:
stepper --resume <session-id>プロジェクトに.stepper/ディレクトリがあれば、引数なしでstepperを実行でき、設定済みのパイプライン、モデル、モードが使用されます。
CLIリファレンス
完全な使用法の1行と、利用可能なすべてのコマンドおよびグローバルオプションです。
sh
stepper [OPTIONS] [COMMAND]コマンド
| Command | 動作 |
|---|---|
| run | 対話型TUIを起動します（サブコマンドなしの場合のデフォルト）。 |
| auth login --codex | Codexバックエンド用にChatGPTへサインインします（OAuth/PKCE）。 |
| auth set-key <provider> | プロバイダーのAPIキーをOSキーリングに保存します（stdinから読み込み）。 |
| auth delete-key <provider> | OSキーリングからプロバイダーのキーを削除します。 |
| config --schema | setting.jsonのJSON Schemaを出力します。 |
| config --validate | プロジェクトのsetting.jsonを検証します。 |
| doctor | 統合診断を実行 — 設定・provider キー・モデル resolve・MCP・カタログ・最新リリースを一括チェック。 |
| session rename <id> <name> | 保存されたセッション名をコマンドラインから変更します。 |
| init | .stepper/をスキャフォールドします（スタックを検出 → stepper.md + setting.json）。 |
グローバルオプション
| Flag | 意味 |
|---|---|
| --model <provider/model-id> | デフォルトモデル、例: anthropic/claude-sonnet-4、ollama-cloud/qwen3-coder、omlx/deepseek-coder。 |
| --mode <auto|plan|accept-edits> | 権限モード（優先順位: フラグ > setting.jsonのmode > accept-edits）。 |
| -p, --print <prompt> | ヘッドレスのワンショット: プロンプトを実行し、stdoutにストリーミングし、自動承認します。 |
| --resume <session-id> | 保存されたセッションを続行します（以前のコンテキストをシードとして使用）。 |
| --fallback-model <a,b,c> | 主モデルが失敗したときに順に試すカンマ区切りのモデルチェーン（CLI が setting.json より優先）。 |
| --output-schema <inline|file> | ヘッドレス: 最終応答を JSON Schema に準拠させる（--output-schema-retries、既定 2）。 |
| --cwd <dir> | 別のディレクトリを対象に実行します。 |