# list

## Usage

```bash
bdy environment list|ls [options]
```

## Options

| **Option** | **Description** |
| :--- | :--- |
| `-w, --workspace <domain>` | Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE |
| `-p, --project <name>` | Project name. Can be set via variable: BUDDY_PROJECT |
| `--scope <scope>` | Force scope (WORKSPACE, PROJECT). By default calculated by provided options and environmental variables (--project, BUDDY_PROJECT, linked project) |
| `--format <text|json>` | Output format: json, text. Default: text |
| `-h, --help` | display help for command |

## Examples

### List environments (workspace, or the linked project when run inside one)

```bash
bdy env ls
```

### List workspace environments

```bash
bdy env ls --scope WORKSPACE
```

### List environments in a project

```bash
bdy env ls -p project
```


---
Original source: https://buddy.works/docs/cli/environment/list