gb ps

Show running local genboxes with process information.

Synopsis


gb ps

Description

Displays information about running local genboxes created with Multipass VMs. Shows the VM name, status, IP address, resource allocation, and process ID for debugging.

Examples

Show Running Genboxes


gb ps


=== Running Local Genboxes ===

genbox-my-app
  Status:    Running
  IP:        192.168.64.5
  Resources: 4 CPUs, 8GiB
  PID:       12345 ← Find this in Activity Monitor

genbox-api-test
  Status:    Running
  IP:        192.168.64.6
  Resources: 2 CPUs, 4GiB
  PID:       12789 ← Find this in Activity Monitor

Tip: In Activity Monitor, search for "qemu" to see all VM processes

No Running Genboxes


gb ps


=== Running Local Genboxes ===

No running genboxes found.

Output Fields

Field	Description
Name	VM name (genbox-{name})
Status	Running, Stopped, Starting, etc.
IP	IPv4 address for SSH access
Resources	CPU count and memory allocation
PID	Process ID for Activity Monitor

Requirements

Multipass must be installed and running
Only shows Multipass VMs (not Docker containers)

Use Cases

Debugging: Find the PID to investigate resource usage
Monitoring: Check which genboxes are running
Troubleshooting: Identify stopped or crashed VMs

Notes

Only shows local Multipass VMs, not cloud genboxes
Use gb list to see all genboxes (local and cloud)
PIDs can be found in Activity Monitor (macOS) or Task Manager (Windows)
Search for “qemu” in Activity Monitor to find VM processes