Skip to content
[bhatti]

bhatti shell

Open an interactive terminal inside a sandbox. Aliased as bhatti sh.

Synopsis

Section titled “Synopsis”
bhatti shell <sandbox> [--new]
bhatti sh <sandbox>

Description

Section titled “Description”

Opens a WebSocket connection to the sandbox’s guest agent and attaches a PTY session. The default shell is /bin/zsh. Terminal resize is forwarded to the guest.

Detach with Ctrl+\. The shell keeps running; output flows into a 64 KB scrollback ring buffer in the guest. Reconnect with bhatti shell <sandbox> and you’ll see the recent scrollback followed by live I/O. Detach does not send SIGHUP — child processes survive.

Single attached client per session. If you reattach from a second machine, the first client is disconnected. Use --new to force a brand-new session instead of reattaching.

Clean exit vs. lost connection. When the shell exits cleanly (Ctrl+D, exit), the CLI returns silently. Any other disconnection (network drop, server restart) shows:

connection lost (session s3f9 still running)
reconnect: bhatti shell dev

The session keeps running in the guest. Reattach with the same command to pick it back up.

Examples

Section titled “Examples”
Terminal window
bhatti shell dev
Terminal window
# Force a new session, even if one is already attached
bhatti shell dev --new
Terminal window
# Detach scenario:
bhatti shell dev          # attach, run things, hit Ctrl+\
# ...session keeps running in the guest...
bhatti shell dev          # reattach later, scrollback replayed

Options

Section titled “Options”
FlagDefaultDescription
--newfalseDon’t reattach to an existing session. Start a fresh one. The previous session, if any, is left running.

See Global flags for --url, --token, --json, --timing, --data-dir.

See also

Section titled “See also”