agentkernel list

List all sandboxes and their status.

Usage

agentkernel list [OPTIONS]

Options

Option	Description
--project	Filter to sandboxes matching the current git project

Output

NAME                           STATUS     BACKEND
my-project                     running    docker
claude-sandbox                 stopped    docker
test-env                       running    podman
myrepo-feature-auth            running    docker

Columns

Column	Description
NAME	Sandbox name
STATUS	running or stopped
BACKEND	Backend used: docker, podman, firecracker, apple

Examples

# List all sandboxes
agentkernel list

# Filter to sandboxes for the current git project
# (matches sandboxes whose name starts with the project directory name)
agentkernel list --project

# No sandboxes
$ agentkernel list
No sandboxes found.

Create one with: agentkernel create <name>

Notes

• Lists sandboxes from all backends
• Running status is checked live against the container runtime
• Sandbox state is stored in ~/.local/share/agentkernel/sandboxes/
• --project uses git rev-parse to detect the current project name and filters by prefix