Skip to main content

bonya session

Aliases: sess, s
Managed sessions are named terminals that keep running after you disconnect, and survive the sandbox suspending and resuming. Reattaching replays what the session produced while nobody was watching. For the common case — “give me a shell” — use bonya console instead, which is a shortcut for attaching to a session named console. Use bonya session directly when you want a named, scriptable session (a dev server, a long build) that isn’t the interactive console.

create

Creates a named managed session running a given command.

list

Lists a sandbox’s managed sessions.
If the sandbox is currently suspended, the listing is served from a suspend-time snapshot and the output notes that explicitly. On a real terminal, bonya session list looks like this:

attach

Connects to a running managed session.
From a terminal, attach is fully interactive: stdin is forwarded and window resizes propagate. Piped or redirected, it streams the session’s output read-only:
Attaching preempts any other client already attached to that session — only one live attachment exists at a time. Detaching (Ctrl+D, closing the terminal) leaves the session itself running.

kill

Kills a managed session.