Skip to main content

​
bonya console [sandbox]

Aliases: sh, shell
Opens an interactive shell in a sandbox — the command you want most of the time.
The sandbox argument accepts a name or id interchangeably — see Sandbox resolution for exactly how that’s decided. Omit it to pick from a list of your sandboxes.

​
What it does

  1. Resumes the sandbox if it’s currently suspended, with a spinner while it wakes. Attaching would trigger the wake anyway, but doing it explicitly first means the wait is visible instead of looking like a hang.
  2. Attaches to the sandbox’s console session, creating it if it doesn’t exist yet. console is a reserved session name used specifically for this command, so repeated runs of bonya console land back in the same session rather than piling up new ones.
  3. If a console session exists but has already finished (exited, killed, or failed), it’s replaced with a fresh one rather than reused.
Leaving the console (Ctrl+D, exit, or closing the terminal) detaches from the session — it keeps running in the sandbox. Running bonya console again reattaches to the same place, replaying any scrollback produced while you were away.

​
Flags

Passing --session points console at a different managed session — useful for keeping a dedicated long-running terminal (say, dev) separate from your interactive one.

​
Examples

For full control over managed sessions — listing them, creating one running a specific command, killing one — see bonya session. console is a convenient shortcut for the single most common case.