| name | smithers-gui |
| description | Open a directory's workspace in the Smithers UI: starts (or attaches to) the workspace Gateway and opens the MOST RECENT run's workflow UI; pass --workflow <id> to open a specific workflow UI directly. Run `smithers gui --help` for usage details. |
| requires_bin | smithers |
| command | smithers gui |
smithers gui
Open a directory's workspace in the Smithers UI: starts (or attaches to) the workspace Gateway and opens the MOST RECENT run's workflow UI; pass --workflow to open a specific workflow UI directly.
Arguments
| Name | Type | Required | Description |
|---|
path | string | no | Directory path (defaults to current working directory) |
Options
| Flag | Type | Default | Description |
|---|
--gateway | string | | Gateway base URL (default http://127.0.0.1:). |
--port | number | 7331 | Gateway port when --gateway is not set. |
--workflow | string | | Open this workflow's UI directly, skipping run lookup. |
--open | boolean | true | Open a browser. Use --no-open to just print the URL. |
--autostart | boolean | true | If no Gateway is reachable on the local port, start one automatically. Use --no-autostart to disable. |
--daemon | boolean | true | Allow a background gateway daemon. Use --no-daemon (or SMITHERS_NO_DAEMON=1) to force direct/embedded operation and never autostart one — for CI, sandboxes, and containers. |
