インストール

事前ビルドされたバイナリで stepper をインストールするか、ソースからビルドし、ガイド付きセットアップまたは環境変数のオーバーライドで初回起動を構成します。

事前ビルドされたバイナリを使うか、開発用にソースからビルドするか、インストールディレクトリとダウンロード先をカスタマイズして stepper を始めましょう。初回起動時のガイド付きセットアップが、デフォルトモデルと権限モードの構成を支援します。

事前ビルドされたバイナリ

Rust ツールチェーンを持たないエンドユーザーが stepper を最も手早くインストールする方法です。インストーラーは OS とアーキテクチャを検出して適切なアーカイブをダウンロードし、stepper を PATH に追加します。

インストールコマンド

# macOS / Linux
curl -fsSL https://stepper.gumyo.net/install-files/install.sh | bash
# Windows (PowerShell)
irm https://stepper.gumyo.net/install-files/install.ps1 | iex

インストーラーは stepper バイナリを ~/.local/bin（Windows では %USERPROFILE%\.local\bin）に配置し、そのディレクトリを PATH に追加するようシェル構成を更新します。

環境変数

次の環境変数で、ダウンロード先とインストールディレクトリをカスタマイズできます:

環境変数	デフォルト	用途
`STEPPER_DOWNLOAD_BASE_URL`	`https://stepper.gumyo.net/install-files`	リリースアーカイブのホスティング先
`STEPPER_INSTALL_DIR`	`~/.local/bin`	インストールディレクトリ

リリースアーカイブ

インストールスクリプトは、システムに合った適切なアーカイブをダウンロードします。次のアーカイブは、すべての prod リリースで、バージョン付きとバージョンなしの両方の形式で公開されます:

stepper-aarch64-apple-darwin.tar.gz — macOS (Apple Silicon)
stepper-x86_64-unknown-linux-gnu.tar.gz — Linux x86_64
stepper-x86_64-pc-windows-msvc.zip — Windows x86_64

インストールスクリプトとバイナリは、このリポジトリとは別のプロジェクトでホスティングされています。STEPPER_DOWNLOAD_BASE_URL を別の場所に指定すれば、自分でホスティングしたアーカイブからダウンロードできます。

ソースからビルド

コントリビューターや開発者は、Rust 1.95 stable（edition 2024）を使って stepper をソースからビルドします。

ビルドコマンド

scripts/install.sh                                  # cargo build + install to ~/.local/bin
STEPPER_INSTALL_DIR=/usr/local/bin sudo -E scripts/install.sh
cargo install --path crates/stepper-cli             # installs `stepper`
cargo build --release --bin stepper                 # binary at target/release/stepper
cargo run                                           # run from source (interactive TUI)

品質ゲート

ビルドを検証するには、次のチェックをローカルで実行してください。CI でも同じゲートが実行されます:

cargo build --workspace
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace            # live tests are #[ignore]/env-gated, so skipped

初回起動

.stepper/ ディレクトリのないプロジェクトで stepper を起動すると、開始を支援するための短いガイド付きセットアップが実行されます。この対話型のプロセスで構成ファイルが作成されます。

ガイド付きセットアップ

初回起動時、stepper は次の項目を尋ねます:

デフォルトモデルの選択
権限モードの選択

その後、セットアップは .stepper/setting.json と .stepper/stepper.md を書き込んでプロジェクトを構成します。

セットアップのスキップまたはカスタマイズ

--no-init フラグまたは STEPPER_NO_INIT=1 環境変数で、対話型のガイド付きセットアップをスキップできます。stepper init を実行すると、構成ファイルを非対話的にスキャフォールディングします:

# Skip interactive setup
stepper --no-init

# Or set the environment variable
STEPPER_NO_INIT=1 stepper

# Scaffold non-interactively
stepper init

ヘッドレスモード（-p フラグを使用）は、プロンプトを完全にバイパスし、デフォルト値で実行し、構成ファイルを作成しません。