FAQ

Do I run labgate ui on the compute node?

No. Run UI on the login node. Compute nodes are for the agent session itself (labgate claude inside srun).

Do I need to use Apptainer?

Yes for the primary HPC path. If needed, pin runtime explicitly with labgate config set runtime apptainer.

Can I launch Claude directly on the login node?

You can for quick checks, but production HPC usage should run agent workloads on compute nodes through your scheduler.

labgate ui says tmux is required but unavailable. What should I do?

Install or load host tmux on the login node, then set LABGATE_TMUX_BIN if needed:

module load tmux
export LABGATE_TMUX_BIN="$(which tmux)"
labgate ui

How do I verify my session started correctly?

Use labgate status in the shell and the UI session list in your browser.

How do I reconnect to a detached terminal later?

Use labgate continue --latest or pass an explicit session id/name with labgate continue <idOrName>.

Where should I look when docs and CLI behavior differ?

Treat CLI help as source-of-truth: run labgate --help, then labgate <command> --help. This page is aligned to that output.