Process Control

Stackie manages every sandbox through a well-defined lifecycle. When you run stackie up, each block’s sandbox is spawned, monitored, and cleaned up automatically.

Sandbox Lifecycle

Created ──► Starting ──► Running ──► Stopping ──► Stopped
               │             │                        │
               └── Failed    └── Die (unexpected) ────┘
                                     │
                                 Restarting

• Created — sandbox configuration is resolved but the process has not started
• Starting — the process is launching; health checks have not passed yet
• Running — health checks are passing; the service is ready
• Failed — the process exited unexpectedly during startup
• Restarting — automatic restart after an unexpected exit while running
• Stopping / Stopped — graceful shutdown via stackie down

Checking Sandbox Status

# List all running sandboxes
stackie ps

# View detailed status for a specific sandbox
stackie status <sandbox>