レイヤーパイプライン
各 step は独自のモデル・ツール・システムプロンプトを持つ独立したサブエージェントです。デフォルトは順次実行で、レイヤーに parallel: true を指定するとサブタスクごとに 1 ワーカーへ fan-out します。名前付きサブエージェントは #agent または task ツールでインラインに呼び出せます。
レイヤー型 AI コーディングエージェント
ひとつのエージェント、知性のパイプライン。
stepper はレイヤー型の CLI/TUI コーディングエージェントです。オーケストレーターがあなたのタスクを、順序付けられたサブエージェントのレイヤーパイプラインに委譲します — 各レイヤーは独自のプロバイダー・モデルと新しいコンテキストウィンドウを持ちます。
curl -fsSL https://stepper.gumyo.net/install-files/install.sh | bashirm https://stepper.gumyo.net/install-files/install.ps1 | iexOS とアーキテクチャを検出し、バイナリを PATH に配置します。
仕組み
オーケストレーターがベースレイヤーです。setting.json の step を順番に実行し、各レイヤーのフリーテキストの結果を次のレイヤーへ渡します。すべてのレイヤーは、独自のモデル・ツール・システムプロンプトと新しいコンテキストウィンドウを持つサブエージェントです。
オーケストレーター
ベースレイヤー · setting.json を読む · パイプラインをルーティング
フリーテキストの受け渡し
plan
リポジトリを読み、方針を立てます
モデル: anthropic/claude-sonnet-4新しいコンテキスト
フリーテキストの受け渡し
implementparallel: true
ツールでファイルを編集します
モデル: omlx/deepseek-coder新しいコンテキスト
レイヤーは fan-out できます — サブタスクごとに 1 つのワーカーがそれぞれ新しいコンテキストウィンドウで実行され、次の step の前に統合されます。
フリーテキストの受け渡し
test
実行して検証します
モデル: ollama-cloud/qwen3-coder新しいコンテキスト
機能
すべてがレイヤー化・スコープ化され、デフォルトで fail-closed です。
マルチプロバイダー
Anthropic、OpenAI、ollama-cloud、oMLX（ローカルの Apple Silicon MLX）、Codex（ChatGPT OAuth）。/connect で models.dev カタログから任意のプロバイダーを検索・追加でき（非対応エントリは無効表示となり、キーが誤ルーティングされることはありません）、各レイヤーが独自のプロバイダーとモデルを選び、モデルごとの context・pricing オーバーライドも任意で設定できます。
編集とコードインテリジェンス
完全なファイルツールに加え、複数ファイルの構造化編集を行う apply_patch、組み込みフォーマッターカタログによるオプトインの format-on-edit、そしてインストール済みの言語サーバーから得た LSP 診断を各編集後にエージェントへフィードバックします。
権限システム
デフォルトの auto は、読み取り専用ツールをどこでも確認なしに実行し、プロジェクト内の編集を自動適用し、プロジェクト外への書き込みだけを確認します。plan と accept-edits がモードを補い、その上に allow / ask / deny ルール、永続化された approvals、そして該当する場所でのみ読み込まれる path-scoped ルールが乗ります。ヘッドレスの -p はデフォルト deny — fail-closed です。
TUI
ratatui 製のターミナル UI：テーマごとに彩色されたパネル上のライブ Markdown、ステータスフッター（アクティブレイヤー · モデル · トークン · ctx% ゲージ · コスト · effort）、diff 承認オーバーレイ、Ctrl+R 逆検索を備えたコマンド履歴、ask-user-question 選択オーバーレイ、/settings、13 種の組み込みパレットを備えた /theme エディター、入力で絞り込む /models ピッカー、/connect、/effort、/editor（Ctrl+E）、/rename · /export、/undo · /redo、そしてオプションのターミナルベル通知。あるいは -p、--agent、--file、--format json でヘッドレス実行。
セッションと制御
セッション resume、list / delete · /rename · /export と --fork、checkpoint + 範囲指定 /rewind（code · conversation）、/undo · /redo、自動コンテキスト圧縮と microcompaction、主モデル失敗時の fallback モデルチェーン、セッションをまたぐ自動メモリ、9 つのライフサイクル hooks、調整可能な推論強度、progressive disclosure 方式の skills、スラッシュコマンド、MCP サーバー（stdio/http、サーバーごとの設定 + OAuth）、そして stepper stats によるセッション横断の利用統計。
設定とエンタープライズ
{env:} / {file:} 置換と STEPPER_CONFIG オーバーライドに対応する JSONC の setting.json、階層的に累積する CLAUDE.md コンテキスト、カスタムキーバインドとカスタム statusline、stepper doctor 統合チェック、ヘッドレスのシステムプロンプトオーバーライドと --output-schema structured outputs、stepper mcp 管理 CLI（list / get / add / remove）、明示的な HTTP(S) プロキシとプライベート CA サポート、そしてリモート MCP サーバー向けの OAuth。
インストール
ビルド済みバイナリを入手 — Rust ツールチェーンは不要です。
macOS / Linux
curl -fsSL https://stepper.gumyo.net/install-files/install.sh | bashWindows
irm https://stepper.gumyo.net/install-files/install.ps1 | iexmacOS
Apple Silicon
aarch64-apple-darwin直接ダウンロード.tar.gzLinux
x86_64
x86_64-unknown-linux-gnu直接ダウンロード.tar.gzWindows
x86_64
x86_64-pc-windows-msvc直接ダウンロード.zip環境変数のオーバーライド
STEPPER_INSTALL_DIR~/.local/binバイナリのインストール先。STEPPER_DOWNLOAD_BASE_URLreleases/latest/downloadアーカイブのホスト先。ソースからビルド
Rust 1.95 ツールチェーンを持つコントリビューターは直接ビルドできます：
cargo install --path crates/stepper-cliクイックスタート
プロジェクトで stepper を実行し、ガイド付きセットアップに従います。
- 1
実行する
.stepper/ が無いプロジェクトでは、stepper が短いガイド付きセットアップを実行します。
stepper - 2
モデルとモードを選ぶ
デフォルトモデルと権限モードを選びます。stepper が .stepper/setting.json を書き出します。
stepper config --validate - 3
ヘッドレスで
ワンショットの出力を stdout にストリーミングし、プロジェクト内の操作を自動承認します。
stepper -p "add a README badge" --mode auto
.stepper/setting.json
{
"defaultModel": "anthropic/claude-sonnet-4",
"mode": "accept-edits",
"step": ["plan", "implement", "test"]
}レイヤーパイプライン、デフォルトモデル、プロバイダーごとの設定 — camelCase で、ユーザーレベルのベースに deep-merge されます。
ドキュメント
完全な使い方・設定・providers・レイヤー・権限・CI を、ここで直接読めます。