레이어 파이프라인
각 step은 자신만의 모델·도구·시스템 프롬프트를 가진 독립 sub-agent입니다. 기본은 순차 실행이며, 레이어에 parallel: true를 지정하면 서브태스크마다 워커 하나로 fan-out 합니다. #agent나 task 도구로 이름이 지정된 sub-agent를 인라인으로 디스패치할 수 있습니다.
레이어형 AI 코딩 에이전트
하나의 에이전트, 여러 지성의 파이프라인.
stepper는 레이어형 CLI/TUI 코딩 에이전트입니다. 오케스트레이터가 작업을 순서가 정해진 sub-agent 레이어 파이프라인으로 위임합니다 — 각 레이어는 자신만의 provider·모델과 새 컨텍스트 윈도우를 가집니다.
curl -fsSL https://stepper.gumyo.net/install-files/install.sh | bashirm https://stepper.gumyo.net/install-files/install.ps1 | iexOS와 아키텍처를 감지해 바이너리를 PATH에 설치합니다.
동작 방식
오케스트레이터가 base 레이어입니다. setting.json의 step을 순서대로 실행하며, 각 레이어의 자유 텍스트 결과를 다음 레이어로 넘깁니다. 모든 레이어는 자신만의 모델·도구·시스템 프롬프트와 새 컨텍스트 윈도우를 가진 독립 sub-agent입니다.
오케스트레이터
base 레이어 · setting.json 읽기 · 파이프라인 라우팅
자유 텍스트 전달
plan
저장소를 읽고 접근 방식을 설계합니다
모델: anthropic/claude-sonnet-4새 컨텍스트
자유 텍스트 전달
implementparallel: true
도구로 파일을 수정합니다
모델: omlx/deepseek-coder새 컨텍스트
레이어는 fan-out 할 수 있습니다 — 서브태스크마다 워커 하나가 각자 새 컨텍스트 윈도우로 실행되고, 다음 step 전에 합쳐집니다.
자유 텍스트 전달
test
실행하고 검증합니다
모델: ollama-cloud/qwen3-coder새 컨텍스트
기능
모든 것이 레이어로 나뉘고, 범위가 한정되며, 기본은 fail-closed입니다.
멀티 프로바이더
Anthropic, OpenAI, ollama-cloud, oMLX(로컬 Apple Silicon MLX), Codex(ChatGPT OAuth). /connect로 models.dev 카탈로그에서 아무 provider나 검색·추가할 수 있고(지원하지 않는 항목은 비활성으로 표시되어 키가 잘못 라우팅되지 않습니다), 모든 레이어가 자신의 provider와 모델을 고르며 모델별 컨텍스트·가격 재정의도 선택적으로 적용할 수 있습니다.
편집 & 코드 인텔리전스
전체 파일 도구에 더해 다중 파일 구조화 편집을 위한 apply_patch, 기본 제공 포매터 카탈로그를 사용하는 선택형 편집 시 자동 포맷, 그리고 설치된 language server에서 나온 LSP 진단을 매 편집 후 에이전트에게 다시 전달합니다.
권한 시스템
기본 모드인 auto는 읽기 전용 도구를 어디서나 확인 없이 실행하고, 프로젝트 내 편집을 자동 적용하며, 프로젝트 외부 쓰기만 확인합니다. plan과 accept-edits가 모드를 보완하고, 그 위에 allow / ask / deny 규칙, 영속 approvals, 그리고 해당 위치에서만 로드되는 path-scoped 규칙이 얹힙니다. 헤드리스 -p는 기본 deny — fail-closed입니다.
TUI
ratatui 터미널 UI: 테마별로 채색된 패널 위의 라이브 마크다운, 상태 푸터(활성 레이어 · 모델 · 토큰 · 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"]
}레이어 파이프라인, 기본 모델, provider별 설정 — camelCase이며 사용자 레벨 base 위에 deep-merge 됩니다.
문서
전체 사용법·설정·providers·레이어·권한·CI를 여기에서 바로 읽어보세요.