퀵스타트 & CLI
stepper를 시작하고 CLI 명령어, 플래그, 모드를 참조하세요.
단 몇 분 만에 stepper를 실행해 보세요. CLI는 에이전트를 사용하는 세 가지 방법을 제공합니다. 대화형 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 레퍼런스
전체 사용법 한 줄과 사용 가능한 모든 명령어 및 전역 옵션입니다.
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 스키마를 출력합니다. |
| 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> | 다른 디렉터리를 대상으로 실행합니다. |