# atmos emulator list

Use this command to list emulator containers in a clean, theme-aware table with a status dot (green when running), a short image name, and the container ID. Containers are discovered by the labels derived from their canonical instance addresses. Scope the output to a single stack with `--stack`, or omit it to list emulators across every stack.

> ⚠️ Experimental

## Usage

```shell
atmos emulator list [flags]
```

Unlike [`atmos emulator ps`](/cli/commands/emulator/ps), `list` does not take a component argument — it lists every emulator (optionally filtered by stack).

## Examples

```shell
# List emulators across all stacks
atmos emulator list

# List emulators in a single stack
atmos emulator list --stack=plat-ue2-dev

# Using the emu alias and the ls shorthand
atmos emu ls --stack=plat-ue2-dev
```

## Flags

- **`-s, --stack`**
  Optional. Restrict the listing to a single stack (for example, 
  `plat-ue2-dev`
  ). When omitted, emulators from every stack are listed.

## See Also

- [`atmos emulator ps`](/cli/commands/emulator/ps) — List running emulators in a component's stack
- [`atmos emulator up`](/cli/commands/emulator/up) — Start (or reuse) the emulator container
- [`atmos emulator logs`](/cli/commands/emulator/logs) — Stream the emulator container's logs