---
title: "clawker container list"
---

## clawker container list

List containers

### Synopsis

Lists all containers created by clawker.

By default, shows only running containers. Use -a to show all containers.

Note: Use 'clawker monitor status' for monitoring stack containers.

```
clawker container list [flags]
```

### Aliases

`list`, `ls`, `ps`

### Examples

```
  # List running containers
  clawker container list

  # List all containers (including stopped)
  clawker container ls -a

  # List containers for a specific project
  clawker container list -p myproject

  # List container names only
  clawker container ls -q

  # Output as JSON
  clawker container ls --json

  # Custom Go template
  clawker container ls --format '{{.Name}} {{.Status}}'

  # Filter by status
  clawker container ls -a --filter status=running

  # Filter by agent name
  clawker container ls --filter agent=dev
```

### Options

```
  -a, --all                  Show all containers (including stopped)
      --filter stringArray   Filter output (key=value, repeatable)
      --format string        Output format: "json", "table", or a Go template
  -h, --help                 help for list
      --json                 Output as JSON (shorthand for --format json)
  -p, --project string       Filter by project name
  -q, --quiet                Only display IDs
```

### Options inherited from parent commands

```
  -D, --debug   Enable debug logging
```

### See also

* [clawker container](clawker_container) - Manage containers
