Skip to content
Fuse
Esc
navigateopen⌘Jpreview
On this page

fuse environment list

List environments, filtered

fuse environment list [flags]

Alias: ls. Scoped to the active host by default (see Hosts); pass --all to see everything across the whole fleet.

Flags

Flag Purpose
--task-id Filter by task ID.
--state Filter by state: provisioning|running|draining|destroying.
--host-id Filter by host ID. Defaults to the active host if --all is not set.
--all List across all hosts, ignoring the active host.

Examples

fuse environment list
# scoped to the active host

fuse environment list --all
# every environment, fleet-wide

fuse environment list --state running --all
# every running environment, fleet-wide

fuse environment list --task-id my-task
$ fuse environment list
ID           STATE    TASK ID   HOST         URL               CREATED
fuse-abc123  running  my-task   prod-east-1  10.0.0.5:19551    2026-01-15 10:00

destroyed and failed are event-stream-only states, emitted over the wire by fuse environment watch but never stored on an environment record, so they are not filterable here. The filter is an exact match with no validation, so an unknown value returns an empty list rather than an error.

Was this page helpful?