설치

사전 빌드된 바이너리를 사용하거나, 개발용으로 소스에서 빌드하거나, 설치 디렉터리와 다운로드 위치를 직접 지정해 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에 추가하도록 셸 설정을 업데이트합니다.

환경 변수

다음 환경 변수로 다운로드 위치와 설치 디렉터리를 사용자 지정할 수 있습니다:

릴리스 아카이브

설치 스크립트는 시스템에 맞는 적절한 아카이브를 다운로드합니다. 다음 아카이브들은 모든 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

소스에서 빌드

기여자와 개발자는 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 플래그 사용)는 프롬프트를 완전히 건너뛰고 기본값으로 실행하며, 구성 파일을 생성하지 않습니다.