Skip to content
[bhatti]

bhatti list

List sandboxes owned by the authenticated user. Aliased as bhatti ls.

Synopsis

bhatti list [-o wide]
bhatti ls [-o wide]

Description

Returns one row per sandbox with status, thermal state, and the first published URL (if any). The default columns are tuned for fitting in a normal terminal; -o wide adds CPUs, memory, disk, and the rootfs image.

The IP column is empty under krucible: sandboxes have no host-visible guest IP — you reach a service inside one by publishing it (bhatti publish) or forwarding a host port to it (bhatti forward), not by dialing a guest address. The column is retained for output compatibility.

Listing does not wake cold sandboxes — the server reads from its database, not from the engines. The THERMAL column shows the current state (hot, warm, cold).

As a side effect, list refreshes the local sandbox-name completion cache (/tmp/bhatti-completions-<uid>). Tab-completing sandbox names will pick up new sandboxes after the first list call following a create from another machine.

Examples

bhatti list

NAME                 STATUS     THERMAL  IP
dev                  running    hot
agent                running    cold
scraper              stopped    -

bhatti ls -o wide

NAME                 STATUS     THERMAL  IP               CPUS   MEMORY   DISK     IMAGE
dev                  running    hot                       1      1024     0        minimal
agent                running    cold                      2      4096     8192     browser
scraper              stopped    -                         1      1024     0        minimal

# Machine-readable output
bhatti ls --json | jq '.[] | select(.status == "running") | .name'

# When at least one sandbox has a published URL, an extra URL column appears
bhatti list

NAME                 STATUS     THERMAL  IP               URL
api                  running    hot                       https://api.bhatti.sh
dev                  running    hot

Options

| Flag | Default | Description | | ---- | ------- | ----------- | | -o, --output <fmt> | (default columns) | Output format. Currently only wide is supported. |

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

See also