The essentials, close at hand.

The CLI works on macOS and Linux. Use it to connect your machine or manage hosted terminals. Browser account, billing, shares, environment variables, and SSH-key management remain in the web app.

Install and sign in

curl -fsSL https://terminalbox.ai/install.sh | sh
~/.local/bin/terminalbox login
~/.local/bin/terminalbox version

CLI sign-in asks for your email and a browser-approved, one-time code. See Access for token and expiry details.

Your machine

terminalbox host install --name "Studio Mac"
terminalbox host status
terminalbox host uninstall

host install starts a per-user background connection. On macOS it uses a LaunchAgent; on Linux it uses a systemd user service. Uninstall stops that service. Revoke the machine in Settings → Machines when its credential should stop working too.

Cloud terminals

terminalbox templates
terminalbox list
terminalbox create codex
terminalbox attach <slug>
terminalbox detach <slug>
terminalbox resume <slug>
terminalbox stop <slug>

detach leaves a hosted session running. stop deletes the individual pane. Creating a hosted coding-agent terminal needs a paid plan; agent-provider usage is separate.

If create loses its response

Check terminalbox list before starting another pane. A response can be lost after the server has already committed the create. Do not blindly repeat the command; use the recovery instructions that match your installed CLI version.