> ## 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 agent and policy 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
* **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 |

VM size is not a project default. Every task selects its size explicitly when it is created, which determines its workspace shape and [credit rate](/concepts/billing-and-credits). Prewarmed capacity is configured separately for each `(project, size)` pair with [warm slots](/concepts/warm-slots).

## 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_aether_prs_auto_trigger` | When automatic review runs on pull requests Aether opened: `disabled`, `on_pr_created`, or `on_every_push` |
| `pr_review_aether_prs_mode` | What a review may push to pull requests Aether opened: `review_only`, `fix_on_request`, or `apply_fixes` |
| `pr_review_other_prs_auto_trigger` | When automatic review runs on all other pull requests: `disabled`, `on_pr_created`, or `on_every_push` |
| `pr_review_other_prs_mode` | What a review may push to all other pull requests: `review_only`, `fix_on_request`, or `apply_fixes`. Fork pull requests are always review only |
| `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).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.