The sandbox-agent daemon is a background server process. Commands like sandbox-agent opencode and gigacode can ensure it is running.
- A daemon-aware command checks for a healthy daemon at host/port.
- If missing, it starts one in the background and records PID/version files.
- Subsequent checks can compare build/version and restart when required.
sandbox-agent opencode and gigacode use ensure-running behavior with upgrade checks.sandbox-agent daemon start uses direct start by default.sandbox-agent daemon start --upgrade uses ensure-running behavior (including version check/restart).
sandbox-agent daemon start [OPTIONS]
| Option | Default | Description |
|---|
-H, --host <HOST> | 127.0.0.1 | Host |
-p, --port <PORT> | 2468 | Port |
--upgrade | false | Use ensure-running + upgrade behavior |
sandbox-agent daemon start
sandbox-agent daemon start --upgrade
sandbox-agent daemon stop [OPTIONS]
| Option | Default | Description |
|---|
-H, --host <HOST> | 127.0.0.1 | Host |
-p, --port <PORT> | 2468 | Port |
sandbox-agent daemon status [OPTIONS]
| Option | Default | Description |
|---|
-H, --host <HOST> | 127.0.0.1 | Host |
-p, --port <PORT> | 2468 | Port |
Daemon state is stored under the sandbox-agent data directory (for example ~/.local/share/sandbox-agent/daemon/):
| File | Purpose |
|---|
daemon-{host}-{port}.pid | PID of running daemon |
daemon-{host}-{port}.version | Build/version marker |
daemon-{host}-{port}.log | Daemon stdout/stderr log |
