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

​

Task defaults

When you create a task without specifying its fields, the task inherits the project’s defaults: 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. Prewarmed capacity is configured separately for each (project, size) pair with warm slots.

​

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.