> ## Documentation Index
> Fetch the complete documentation index at: https://www.ravion.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ravion project

> Create, list, update, and delete Ravion projects and their settings, including default environments and integrations, from the CLI.

## `ravion project`

Manage projects

**Aliases:** `projects`, `proj`

### `ravion project config`

Manage project config

#### `ravion project config apply`

Apply project config

```bash theme={null}
ravion project config apply <id> [flags]
```

**Flags:**

| Flag                               | Required | Description                                                                                                                      |
| ---------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `--file <string>`                  | yes      | File to read project config from                                                                                                 |
| `--autoapprove`                    |          | Pass autoapprove=true to supported stack change pipeline runs                                                                    |
| `--dry-run`                        |          | Validate and print planned changes without applying them                                                                         |
| `--environment-given-id <strings>` |          | Environment given ID to include in the apply target set                                                                          |
| `--environment-id <strings>`       |          | Environment ID to include in the apply target set                                                                                |
| `--json`                           |          | emit response as JSON                                                                                                            |
| `--module-given-id <strings>`      |          | Module instance given ID to include within each selected environment                                                             |
| `--module-instance-id <strings>`   |          | Module instance ID to include in the apply target set                                                                            |
| `--run-ordering <string>`          |          | Controls whether co-applied module stack runs wait for dependency stack runs to succeed. Available values: dependency, parallel. |

#### `ravion project config pull`

Pull project config

```bash theme={null}
ravion project config pull <id> [flags]
```

**Flags:**

| Flag              | Required | Description                     |
| ----------------- | -------- | ------------------------------- |
| `--file <string>` | yes      | File to write project config to |

#### `ravion project config schema`

Print project config file schema

```bash theme={null}
ravion project config schema
```

### `ravion project create`

Create Project

```bash theme={null}
ravion project create [flags]
```

**Flags:**

| Flag                     | Required | Description                                                           |
| ------------------------ | -------- | --------------------------------------------------------------------- |
| `--given-id <string>`    | yes      | User-provided project identifier. Must be unique within organization. |
| `--name <string>`        | yes      | name                                                                  |
| `--description <string>` |          | description                                                           |
| `--json`                 |          | emit response as JSON                                                 |

### `ravion project delete`

Delete Project

```bash theme={null}
ravion project delete <id> [flags]
```

**Flags:**

| Flag        | Required | Description              |
| ----------- | -------- | ------------------------ |
| `-y, --yes` |          | skip confirmation prompt |

### `ravion project get`

Get Project by id

```bash theme={null}
ravion project get <id> [flags]
```

**Flags:**

| Flag     | Required | Description           |
| -------- | -------- | --------------------- |
| `--json` |          | emit response as JSON |

### `ravion project list`

List Projects

```bash theme={null}
ravion project list [flags]
```

**Flags:**

| Flag                | Required | Description           |
| ------------------- | -------- | --------------------- |
| `--cursor <string>` |          | cursor                |
| `--json`            |          | emit response as JSON |
| `--limit <int>`     |          | limit                 |
| `-v, --verbose`     |          | show full output      |

### `ravion project update`

Patch Project

```bash theme={null}
ravion project update <id> [flags]
```

**Flags:**

| Flag                     | Required | Description                                                           |
| ------------------------ | -------- | --------------------------------------------------------------------- |
| `--description <string>` |          | description                                                           |
| `--given-id <string>`    |          | User-provided project identifier. Must be unique within organization. |
| `--json`                 |          | emit response as JSON                                                 |
| `--name <string>`        |          | name                                                                  |