Sandbox Commands

The ve sandbox commands let you list, inspect, connect to, and terminate running sandboxes from the command line. These commands are useful for debugging, monitoring, and managing your sandbox instances.

List Running Sandboxes

Show all sandboxes currently running in your account:

ve sandbox list

Example output:

$ ve sandbox list

  ID           TEMPLATE         STATUS    STARTED          CPU    MEM
  abc123def4   base             running   2 minutes ago    12%    128MB
  xyz789ghi0   custom-python    running   15 minutes ago   3%     256MB
  jkl456mno1   data-science     running   1 hour ago       0%     512MB

  3 sandboxes running

Filter by Template

List only sandboxes using a specific template:

ve sandbox list --template custom-python

$ ve sandbox list --template custom-python

  ID           TEMPLATE         STATUS    STARTED          CPU    MEM
  xyz789ghi0   custom-python    running   15 minutes ago   3%     256MB

  1 sandbox running

Connect to a Sandbox

Open an interactive shell session inside a running sandbox via SSH:

ve sandbox connect <sandbox-id>

$ ve sandbox connect abc123def4
Connecting to sandbox abc123def4...
✓ Connected.

user@sandbox:~$ whoami
user
user@sandbox:~$ ls /home/user
documents  projects  data
user@sandbox:~$ exit
Connection closed.

The connect command establishes an SSH tunnel through the Vibengine API. You do not need to configure SSH keys or open any ports.

View Sandbox Logs

Retrieve logs from a running or recently terminated sandbox:

ve sandbox logs <sandbox-id>

$ ve sandbox logs abc123def4

[2026-02-21T10:30:01Z] Sandbox started (template: base)
[2026-02-21T10:30:02Z] Kernel ready
[2026-02-21T10:30:05Z] Execution: print("hello") -> completed (42ms)
[2026-02-21T10:32:15Z] Execution: import pandas as pd -> completed (1.2s)
[2026-02-21T10:32:20Z] Execution: df.describe() -> completed (89ms)

Follow Logs in Real-Time

Use the --follow flag to stream logs as they happen:

ve sandbox logs <sandbox-id> --follow

Press Ctrl+C to stop following.

Limit Log Output

Show only the last N lines:

ve sandbox logs <sandbox-id> --tail 20

Kill a Sandbox

Terminate a running sandbox immediately:

ve sandbox kill <sandbox-id>

$ ve sandbox kill abc123def4
✓ Sandbox abc123def4 terminated.

Kill Multiple Sandboxes

Terminate several sandboxes at once:

ve sandbox kill abc123def4 xyz789ghi0

$ ve sandbox kill abc123def4 xyz789ghi0
✓ Sandbox abc123def4 terminated.
✓ Sandbox xyz789ghi0 terminated.

Kill All Running Sandboxes

This terminates every running sandbox in your account. Use with caution.

ve sandbox kill --all

$ ve sandbox kill --all
This will terminate all 3 running sandboxes. Continue? (y/N) y
✓ Sandbox abc123def4 terminated.
✓ Sandbox xyz789ghi0 terminated.
✓ Sandbox jkl456mno1 terminated.
All sandboxes terminated.

Sandbox Info

Get detailed information about a specific sandbox:

ve sandbox info <sandbox-id>

$ ve sandbox info abc123def4

  ID:         abc123def4
  Template:   base
  Status:     running
  Started:    2026-02-21T10:30:01Z (5 minutes ago)
  CPU:        12%
  Memory:     128MB / 512MB
  Timeout:    300s remaining
  Metadata:   {"user_id": "usr_123", "session": "demo"}

Command Reference

Command	Description
`ve sandbox list`	List all running sandboxes
`ve sandbox list --template <name>`	Filter sandboxes by template
`ve sandbox connect <id>`	SSH into a running sandbox
`ve sandbox logs <id>`	View sandbox logs
`ve sandbox logs <id> --follow`	Stream logs in real-time
`ve sandbox kill <id>`	Terminate a sandbox
`ve sandbox kill --all`	Terminate all sandboxes
`ve sandbox info <id>`	Show detailed sandbox info

Sandbox Commands

On this page