# pier projects

> Projects: list, add, inspect, remove, pause, switch

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

```bash
pier projects <command>
```

Projects: list, add, inspect, remove, pause, switch.

## Subcommands

### pier projects ls

```bash
pier projects ls
```

List projects.

### pier projects add

```bash
pier projects add <name> [flags]
```

Add a project.

| Argument | Required | Description  |
| -------- | -------- | ------------ |
| `<name>` | yes      | Project name |

| Flag     | Value    | Default | Description                                     |
| -------- | -------- | ------- | ----------------------------------------------- |
| `--slug` | `STRING` |         | URL-safe identifier (auto-generated if omitted) |

### pier projects info

```bash
pier projects info <project>
```

Show project details.

| Argument    | Required | Description               |
| ----------- | -------- | ------------------------- |
| `<project>` | yes      | Project name, slug, or ID |

### pier projects use

```bash
pier projects use [<ref>]
```

Switch the active project (picker when no name is given).

| Argument | Required | Description                             |
| -------- | -------- | --------------------------------------- |
| `<ref>`  | no       | Project name, slug, or ID; omit to pick |

### pier projects rm

```bash
pier projects rm [<project>] [flags]
```

Remove a project.

| Argument    | Required | Description               |
| ----------- | -------- | ------------------------- |
| `<project>` | no       | Project name, slug, or ID |

| Flag          | Value | Default | Description              |
| ------------- | ----- | ------- | ------------------------ |
| `-y`, `--yes` |       |         | Skip confirmation prompt |

### pier projects pause

```bash
pier projects pause [flags]
```

Pause an entire project (recoverable).

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

### pier projects resume

```bash
pier projects resume [flags]
```

Resume a paused project.

| 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.