Projects

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
• 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 for creating, listing, and deleting projects.

​

Task defaults

When you create a task without specifying its fields, the task inherits the project’s defaults: Hardware (the VM size) is set on the project directly rather than in task defaults, and drives what each task costs in credits.

​

PR review policy

A project carries policy fields that control how the agent reviews pull requests: PR review applies only when the project is linked to a GitHub repository. See the GitHub integration guide.

​

API and CLI

• Manage projects over the API: Projects API.
• Manage projects from the terminal: aether project.