Core Session Commands
Primary day-to-day flow for HPC usage. Claude + Apptainer remains the recommended path.
labgate init
Create (or overwrite) ~/.labgate/config.json.
labgate init [--force]| Option | Description |
|---|---|
--force | Overwrite existing config file. |
labgate claude
Launch Claude in a sandboxed container (primary path).
labgate claude [workdir]| Option | Description |
|---|---|
--dry-run | Print runtime command without launching. |
--image <uri> | Override configured image. |
--no-footer | Disable status footer line. |
--verbose | Show detailed startup/config output. |
--api-key <key> | Use Anthropic API key directly (skip browser OAuth). |
labgate codex
Launch Codex in a sandboxed container (secondary path).
labgate codex [workdir]| Option | Description |
|---|---|
--dry-run | Print runtime command without launching. |
--image <uri> | Override configured image. |
--no-footer | Disable status footer line. |
--verbose | Show detailed startup/config output. |
--api-key <key> | Pass through API key at launch. |
labgate ui
Run the local dashboard and web terminal control plane.
labgate ui [--port <number> --listen-address <address> --token <string>] | [--socket <path>]| Option | Description |
|---|---|
--port <number> | TCP mode (default 7700 when no socket is given). |
--listen-address <address> | Bind a specific interface (default 127.0.0.1). |
--token <string> | Custom 12-character quick-link token for /s/<token>. |
--socket <path> | Unix socket mode (mutually exclusive with --port). |
labgate status
List running LabGate sessions.
labgate statuslabgate continue
Attach to a running local web terminal session.
labgate continue [idOrName] [--latest]| Option | Description |
|---|---|
--latest | Attach to the most recent runnable local session. |
labgate stop
Stop a running session.
labgate stop <id>labgate restart
Restart a running session with current effective config.
labgate restart <id> [--dry-run]| Option | Description |
|---|---|
--dry-run | Print intended actions without restarting. |
labgate logs
Inspect and optionally stream audit log events.
labgate logs [-n|--lines <count>] [--follow]| Option | Description |
|---|---|
-n, --lines <count> | Number of recent log lines to print (default 20). |
--follow | Keep streaming newly appended entries. |
labgate feedback
Submit user feedback (interactive if no message is supplied).
labgate feedback [message...]Last updated on