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

# Projects

> The project model, per-project task defaults, and PR review policy

A project is the top-level container in Aether. It groups your source code, environment, optional GitHub link, and task history into one unit, and it carries the defaults that new tasks inherit.

## What's in a project

Every project holds:

* **Source code**, stored on a persistent volume inside its workspace
* **Environment variables**, encrypted at rest and injected on workspace start
* **An optional GitHub link** — repository owner, name, default branch, and installation
* **Hardware** — the runtime class (VM size) tasks run on, drawn from the [VM sizes catalog](/concepts/pricing-and-tiers)
* **Task defaults** — the agent, model, and policy a new task inherits
* **PR review policy** — when and how the agent reviews pull requests
* **Tasks** — the history of agent work in the project

Each project has a unique UUID, and you can reference it by its full ID or an 8-character short prefix. See the [Projects guide](/guides/projects) for creating, listing, and deleting projects.

## Task defaults

When you create a task without specifying its fields, the task inherits the project's defaults:

| Field                  | Description                                                              |
| ---------------------- | ------------------------------------------------------------------------ |
| `agent_type`           | The default [agent provider](/concepts/agents-and-models) (e.g. `codex`) |
| `model`                | The default model for that provider                                      |
| `interaction_mode`     | The default interaction mode for new tasks                               |
| `reasoning_effort`     | Optional default reasoning effort, when the model supports it            |
| `auto_fix_ci`          | Automatically address failing CI on the task's pull request              |
| `auto_fix_pr_comments` | Automatically address review comments on the pull request                |
| `auto_rebase`          | Automatically rebase the task branch                                     |

Hardware (the VM size) is set on the project directly rather than in task defaults, and drives what each task costs in [credits](/concepts/billing-and-credits).

## PR review policy

A project carries policy fields that control how the agent reviews pull requests:

| Field                                   | Description                                                                 |
| --------------------------------------- | --------------------------------------------------------------------------- |
| `pr_review_prompt`                      | The prompt the agent uses when reviewing a pull request                     |
| `pr_review_auto_trigger`                | When automatic review runs: `disabled`, `on_pr_created`, or `on_every_push` |
| `pr_review_comment_trigger_enabled`     | Whether a comment can trigger a review                                      |
| `pr_review_respond_to_comments_enabled` | Whether the agent responds to review comments                               |

PR review applies only when the project is linked to a GitHub repository. See the [GitHub integration guide](/guides/github-integration).

## API and CLI

* Manage projects over the API: [Projects API](/api-reference/v1/projects/get-projects).
* Manage projects from the terminal: [`aether project`](/cli/project).