# list

## Usage

```bash
bdy target 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 |
| `--pipeline <identifier>` | Pipeline identifier to scope the target to. Requires --project |
| `--environment <identifier>` | Environment identifier to scope the target to. Resolves a workspace environment; add --project to point at a project environment |
| `--scope <scope>` | Force scope (WORKSPACE, PROJECT, ENVIRONMENT, PIPELINE). By default calculated by provided options and environmental variables (--pipeline, |
| `--environment, --project` | BUDDY_PROJECT, linked project) |
| `--format <text|json>` | Output format: json, text. Default: text |
| `-h, --help` | display help for command |

## Examples

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

```bash
bdy tg ls
```

### List all workspace targets

```bash
bdy tg ls --scope WORKSPACE
```

### List targets in a project

```bash
bdy tg ls -p project
```

### List targets of a pipeline

```bash
bdy tg ls -p project --pipeline pipeline-identifier
```

### List targets of a workspace environment

```bash
bdy tg ls --environment environment-identifier
```

### List targets of a project environment

```bash
bdy tg ls -p project --environment environment-identifier
```


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