# pier workspaces

> Workspaces: switch, pause, resume

URL: https://pier.run/docs/cli/reference/workspaces

```bash
pier workspaces <command>
```

Workspaces: switch, pause, resume.

## Subcommands

### pier workspaces ls

```bash
pier workspaces ls
```

List your workspaces.

### pier workspaces use

```bash
pier workspaces use [<workspace>]
```

Switch the active workspace.

| Argument      | Required | Description                        |
| ------------- | -------- | ---------------------------------- |
| `<workspace>` | no       | Workspace name or ID; omit to pick |

### pier workspaces pause

```bash
pier workspaces pause [flags]
```

Pause an entire workspace (closes the active plan).

| Flag          | Value | Default | Description                                                         |
| ------------- | ----- | ------- | ------------------------------------------------------------------- |
| `-y`, `--yes` |       |         | Skip confirmation                                                   |
| `--no-wait`   |       |         | Return immediately after submitting; don't wait for terminal status |

### pier workspaces resume

```bash
pier workspaces resume [flags]
```

Resume a paused workspace.

| Flag        | Value | Default | Description                                                         |
| ----------- | ----- | ------- | ------------------------------------------------------------------- |
| `--no-wait` |       |         | Return immediately after submitting; don't wait for terminal status |

[Global flags](/docs/cli/reference#global-flags) apply to every command.