Core Concepts
Desktop, terminals, and ports
Use interactive terminals, noVNC desktop sessions, and forwarded preview ports.
Desktop, terminals, and ports
Nimbus exposes the most important sandbox surfaces directly in the app: shell terminals, a desktop tab, and previewable ports.
Terminals
Terminals run inside tmux on the sandbox. Use them for ad hoc commands, logs, and interactive development tools. Long-running servers should use stable tmux sessions so they survive UI reconnects.
Desktop
Desktop access uses a browser-accessible VNC session. It is useful when a task requires visual inspection, browser interaction, or a GUI application running inside the sandbox.
Preview ports
When a dev server listens on the sandbox, Nimbus exposes it through a secure preview URL. Bind web servers to 0.0.0.0; listeners bound only to localhost may not be reachable through the preview tunnel.
Common checks
Use these checks when a preview is not loading:
lsof -nP -iTCP:<port> -sTCP:LISTEN
curl -fsS http://127.0.0.1:<port>/
Confirm that the server is listening on the expected port and that it responds locally before debugging the tunnel.