Skip to main content
Use devbox session to list persistent terminal sessions on a running Devbox or connect to a named session. Connecting activates the selected Devbox.

Usage

devbox session connect

Connect to a named terminal session. Sessions use tmux on Linux and macOS, and psmux on Windows. If you omit --session, the CLI prompts you to select an existing session or enter a name for a new one. A non-interactive invocation must provide a session name. On Windows, session names are case-insensitive and must be valid filenames without dots or surrounding whitespace.

Usage

Connect to a named session

Options

string
Select a Devbox by name or ID instead of using the positional argument.
string
Connect to this terminal session. The session is created if it does not exist.
boolean
default:"false"
Include Devboxes owned by other workspace members when selecting a Devbox.

devbox session list

List terminal sessions on a running Devbox. The default table contains each session’s name and creation time. JSON output also includes the command when the session has one.

Usage

List sessions as JSON

When no sessions exist, the default output is:
Output

Options

string
Set the output format to json. Leave empty for a table.
boolean
default:"false"
Include Devboxes owned by other workspace members when selecting a Devbox.

SSH & Sessions

Create and use persistent sessions.

Execute commands

Run non-interactive retained executions.
Last modified on November 13, 2026