Auto-restart relaunches a command after it exits unexpectedly.
Behavior
When auto-restart is enabled, Solo watches the running command and starts a fresh instance after a crash or unexpected exit. The restart keeps the last crash output in the terminal and adds a restart banner before new output appears.
Solo rate-limits crash restarts to avoid a tight loop: after 10 restarts in a 60-second window, auto-restart pauses for that command and Solo shows an exhausted auto-restart indicator.
Configure
Enable auto-restart in the command settings with Edit command..., or set auto_restart: true for the command in solo.yml.
Notes
- Auto-restart only applies to command processes. Terminals and agents do not use this setting.
- Solo will not start an untrusted command, so auto-restart has no effect until you trust it.
- Auto-restart is separate from file-watch auto-restart, which restarts based on file changes rather than crashes.
- Crash auto-restart is disabled during app shutdown.
- If a command keeps crashing, preserve its output and follow the live application debugging workflow before repeated manual restarts hide the useful evidence.