Command Reference
Every System 0 command with every option. Run s0 --help to see this in your terminal.
Instance Lifecycle
s0 init <name>
Create a new analysis instance.
| Option | Description | Default |
|---|---|---|
--goal, -g | What to analyze (required, or prompted) | |
--owner, -o | Owner identifier | OS username |
--target, -t | Directory to analyze (self for s0 itself) | cwd |
--mode, -m | observe | suggest | auto | supervised | observe |
--model | LLM model | claude-opus-4-6 |
--effort | high | medium | low | high |
--brain-type | claude-code | generic-cli | claude-code |
--budget | Max spending per session (USD) | 50.0 |
--severity-threshold | Min severity to plan a fix (0.0-1.0) | 0.6 |
--risk-threshold | Max risk to auto-execute (0.0-1.0) | 0.7 |
--max-actions | Max fix actions per pass | 3 |
--max-refinements | Max refinement attempts per action | 2 |
--min-passes | Passes required before planning fixes | 2 |
--min-dimensions | Dimensions required before auto-executing | 3 |
--capabilities | Path to capability-map.json | auto-detected |
--max-children | Max child instances per cycle (orchestrator) | 3 |
--max-depth | Max orchestrator nesting depth | 2 |
--no-orchestrator | Disable automatic child spawning |
s0 list
List all instances with generation, pass count, and status.
Execution
s0 run <name>
Run one or more analysis passes.
| Option | Description | Default |
|---|---|---|
--cycles, -c | Number of passes | 1 |
--hours | Run continuously for N hours (overrides --cycles) | |
--mode, -m | Override mode for this run only | |
--model | Override LLM model for this run | |
--effort | Override effort for this run | |
--verbose, -v | Print each finding with severity score |
Inspection
s0 status [name]
Show instance status. Omit name to list all instances.
s0 observe <name>
Show what the system has learned: findings, gaps, and analysis dimensions.
s0 questions <name>
List all analysis dimensions with their performance statistics.
s0 actions <name>
Show history of executed fix actions.
| Option | Description | Default |
|---|---|---|
--limit, -l | Max entries to show | 10 |
s0 budget <name>
Show spending limits (per-pass, per-action, session, lifetime) and current usage.
Configuration
s0 goal <name>
View or update the analysis goal.
| Option | Description |
|---|---|
--set, -s | Set new goal text |
--owner, -o | Owner identifier for the update |
s0 mode <name>
View or change execution mode.
| Option | Description |
|---|---|
--set, -s | Set mode: observe | suggest | auto | supervised |
s0 approve <name>
Approve queued actions (supervised mode only).
| Option | Description |
|---|---|
--all | Approve all pending actions at once |
Lineage
s0 hatch <source> <dest>
Create an evolved offspring that inherits the parent's analysis coverage. Generation counter increments automatically.
| Option | Description |
|---|---|
--goal, -g | New goal (default: inherits parent goal) |
--owner, -o | New owner (default: inherits parent owner) |
s0 hatch0 <name>
Create a pristine offspring that starts from scratch.
| Option | Description |
|---|---|
--goal, -g | Goal for the new instance |
--owner, -o | Owner identifier |
Daemon
s0 install <name>
Install as a background daemon (launchd on macOS, systemd on Linux).
| Option | Description | Default |
|---|---|---|
--interval | Seconds between passes | 300 |
--continuous | Back-to-back passes instead of interval |
s0 uninstall <name>
Remove the background daemon and stop it.
Git Integration
s0 merge <name>
Merge the s0 worktree branch back into the target repo.
| Option | Description | Default |
|---|---|---|
--into | Target branch | repo's current branch |