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

# aether project

> Create, list, and manage Aether projects

# aether project

Manage your Aether projects. Projects contain workspaces, tasks, environment variables, and integration configurations.

## Usage

```bash theme={null}
aether project <subcommand> [flags]
```

## Subcommands

| Subcommand    | Description                                  |
| ------------- | -------------------------------------------- |
| `list`        | List all projects                            |
| `get <id>`    | Get details for a specific project           |
| `create`      | Create a new project                         |
| `update <id>` | Update project metadata and runtime defaults |
| `delete <id>` | Delete a project                             |
| `select [id]` | Set the default project                      |

## aether project list

List all projects in your account.

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

| Flag     | Description    |
| -------- | -------------- |
| `--json` | Output as JSON |

```bash theme={null}
aether project list
```

```
ID              NAME            CREATED
proj_a1b2c3d4   my-app          2025-01-15
proj_e5f6g7h8   backend-api     2025-02-01
```

## aether project get

Get details for a specific project. Supports short ID prefix resolution (first 8 characters).

```bash theme={null}
aether project get <id>
```

```bash theme={null}
aether project get proj_a1b2
```

```
ID:          proj_a1b2c3d4
Name:        my-app
Description: Main application project
Created:     2025-01-15T10:30:00Z
Workspaces:  2
```

## aether project create

Create a new project.

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

| Flag                | Description                          |
| ------------------- | ------------------------------------ |
| `--name`            | Project name (required)              |
| `--description`     | Project description                  |
| `--hardware-preset` | Default hardware preset              |
| `--cpu-kind`        | Default CPU kind                     |
| `--cpus`            | Default CPU count                    |
| `--memory-mb`       | Default memory in MB                 |
| `--volume-size-gb`  | Default volume size in GB            |
| `--gpu-kind`        | Default GPU kind, or `none` to clear |

```bash theme={null}
aether project create --name "my-app" --description "Main application"
```

```
Project created: proj_a1b2c3d4
```

## aether project update

Update project metadata, default workspace hardware, and task defaults.

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

| Flag                     | Description                                     |
| ------------------------ | ----------------------------------------------- |
| `--name`                 | Project name                                    |
| `--description`          | Project description                             |
| `--repo-url`             | Repository URL                                  |
| `--hardware-preset`      | Default hardware preset                         |
| `--cpu-kind`             | Default CPU kind                                |
| `--cpus`                 | Default CPU count                               |
| `--memory-mb`            | Default memory in MB                            |
| `--volume-size-gb`       | Default volume size in GB                       |
| `--gpu-kind`             | Default GPU kind, or `none` to clear            |
| `--agent-type`           | Default task agent type                         |
| `--model`                | Default task model                              |
| `--interaction-mode`     | Default task interaction mode                   |
| `--reasoning-effort`     | Default task reasoning effort, or `none`        |
| `--auto-fix-ci`          | Default CI auto-fix (`true` or `false`)         |
| `--auto-fix-pr-comments` | Default PR comment auto-fix (`true` or `false`) |
| `--auto-rebase`          | Default auto-rebase (`true` or `false`)         |

## aether project delete

Delete a project and all its resources. This action is irreversible.

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

| Flag      | Description              |
| --------- | ------------------------ |
| `--force` | Skip confirmation prompt |

```bash theme={null}
aether project delete proj_a1b2c3d4
```

```
Are you sure you want to delete project "my-app"? This will delete all workspaces, tasks, and configuration. [y/N]
```

```bash theme={null}
aether project delete proj_a1b2c3d4 --force
```

## aether project select

Set the default project for all CLI commands. If no ID is provided, an interactive picker is displayed.

```bash theme={null}
aether project select [id]
```

```bash theme={null}
# Interactive picker
aether project select
```

```
? Select a project:
> my-app (proj_a1b2c3d4)
  backend-api (proj_e5f6g7h8)
```

```bash theme={null}
# Set directly
aether project select proj_a1b2c3d4
```

```
Default project set to: my-app (proj_a1b2c3d4)
```