Documentation
Full usage, configuration, providers, layers, permissions, and CI — read it all right here.
Installation
Install stepper via prebuilt binaries, build from source, and configure your first run with guided setup or environment overrides.
Quickstart & CLI
Get started with stepper and reference the CLI commands, flags, and modes.
Configuration
Configure stepper with camelCase JSON: user-level base merged with project settings, featuring providers, layers, permissions, and MCP servers.
Providers & keys
Configure API keys for five AI providers with environment variables, OS keyring, or explicit config.
Layers
Configure per-layer models, permissions, tools, and skills; run layers sequentially or in parallel fan-out with task assignment.
Permissions
Permission modes and rule specifiers for controlling agent tool access.
Slash commands, skills & MCP
Built-in slash commands, custom commands with permission-gated substitutions, skills with progressive disclosure, and MCP server integration.
Sessions & more
Dispatch, compaction, checkpoints, sessions, hooks, interrupts, and prompt caching features for layered AI coding workflows.
CI & releases
Automated CI pipelines, manual workflow runs, and cross-platform release binaries via GitHub Actions.
Architecture
10-crate Cargo workspace design: crate roles, isolation invariants, and data flow from CLI bootstrap through multi-layer agent orchestration to TUI.
Roadmap
What stepper has shipped, what is being hardened for real-world use, and the limits deliberately deferred.