| name | smithers-gateway |
| description | Serve the multi-run Gateway RPC/WS control plane for workspace run state; unlike up --serve, this is not tied to one run. `smithers gateway status|stop` manages the workspace's running singleton. Run `smithers gateway --help` for usage details. |
| requires_bin | smithers |
| command | smithers gateway |
smithers gateway
Serve the multi-run Gateway RPC/WS control plane for workspace run state; unlike up --serve, this is not tied to one run. smithers gateway status|stop manages the workspace's running singleton.
Arguments
| Name | Type | Required | Description |
|---|
action | string | no | Manage the workspace's singleton gateway instead of serving one: status |
Options
| Flag | Type | Default | Description |
|---|
--host | string | 127.0.0.1 | Gateway bind address |
--port | number | 7331 | Preferred gateway port (falls back to an ephemeral port when taken; clients discover the verified URL with gateway status) |
--backend | string | | Storage behind this workspace Gateway; a boot/deployment choice, not a client run-lookup flag |
--authToken | string | | Bearer token for HTTP/WS auth (or set SMITHERS_API_KEY); required to bind a non-loopback --host |
--mintToken | boolean | false | Mint a random bearer token, require it on every request, and record it only in the 0600 runtime state file |
--insecure | boolean | false | Allow binding a non-loopback --host with NO auth (exposes a full-control, unauthenticated control plane — dangerous) |
--idleTimeout | number | | Exit after this many ms with no clients, in-flight runs, or registered schedules (0 = stay up; autostarted daemons set this automatically). Overridable via SMITHERS_GATEWAY_IDLE_MS. |
