Auto-restart relaunches a command after it exits on its own, whether it succeeds or fails. Clicking Stop keeps the command stopped.
Behavior
When auto-restart is enabled, Solo starts a new instance after the command exits. Solo keeps the previous 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.
To check the behavior with a command that exits successfully, use the automatic restart demo.
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.