aether project

Manage your Aether projects. A project groups source code, environment variables, an optional GitHub link, task defaults, and the history of agent runs. See the Projects guide for concepts.

Usage

aether project <subcommand> [flags]

projects is an alias for project.

Subcommands

Subcommand	Description
`list`	List all projects
`get <id>`	Show project details
`create`	Create a new project
`update <id>`	Update project metadata or task defaults
`archive <id>`	Archive a project
`select [id]`	Set the default project

Most <id> arguments accept a short prefix.

aether project list

aether project list

ID         NAME          REPO                              HARDWARE   UPDATED
a1b2c3d4   my-app        github.com/acme/my-app            medium     2 days ago
e5f6g7h8   backend-api   —                                 small      1 week ago

Projects with no linked repository show — in the REPO column.

aether project get

Show full details for one project.

aether project get a1b2c3d4

Name:        my-app
ID:          a1b2c3d4-e5f6-7890-abcd-ef1234567890
Description: Main application project
Repo:        github.com/acme/my-app
Task defaults:
  Agent:       codex
  Model:       gpt-5.5
  Mode:        default
  Auto-fix CI: true
Created:     Jan 15, 2025
Updated:     2 days ago

aether project create

aether project create [flags]

Flag	Description
`--name`	Project name (prompted if omitted)
`--description`	Project description

aether project create --name "my-app" --description "Main application"

Project created: my-app (a1b2c3d4)

aether project update

Update metadata or task defaults. Only the flags you pass are changed.

aether project update <id> [flags]

Flag	Description
`--name`	Project name
`--description`	Project description
`--agent-type`	Default task agent type
`--model`	Default task model
`--interaction-mode`	Default task interaction mode
`--reasoning-effort`	Default task reasoning effort, or `none` to clear
`--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`)
`--pr-review-trigger`	PR review auto trigger: `disabled`, `on_pr_created`, or `on_every_push`
`--pr-review-comment-trigger`	Enable the `aether review` PR-comment trigger (`true` or `false`)
`--pr-review-respond`	Respond to replies on review comments (`true` or `false`)
`--pr-review-prompt`	Custom PR review prompt; pass `""` to restore the default

aether project update a1b2c3d4 \
  --agent-type codex \
  --model gpt-5.5 \
  --interaction-mode plan \
  --auto-fix-ci true

aether project update a1b2c3d4 \
  --pr-review-trigger on_pr_created \
  --pr-review-respond true

Running update with no flags returns an error — provide at least one.

aether project archive

Archive a project. Live activity stops and the project is hidden from normal views, while task, run, and billing history is retained.

aether project archive <id> [flags]

Flag	Description
`--force`	Skip the confirmation prompt

Archiving destroys the project’s active workspaces and volumes, disables its automations, and removes its environment variables, secret files, and integration routes. Task, run, and billing history is kept. Archiving cannot be undone, but you can create a new project from the same repository.

aether project select

Set the default project for all commands. With no argument, opens an interactive picker.

# Interactive picker
aether project select

# Set directly
aether project select a1b2c3d4

Default project set to: my-app (a1b2c3d4)

Once set, commands like aether run and aether env target this project automatically.

CLI Reference

Core Commands

Account Commands

Workspace Commands

Integration Commands

Provider Auth

Configuration

aether project

Usage

Subcommands

aether project list

aether project get

aether project create

aether project update

aether project archive

aether project select

​Usage

​Subcommands

​aether project list

​aether project get

​aether project create

​aether project update

​aether project archive

​aether project select

Usage

Subcommands

aether project list

aether project get

aether project create

aether project update

aether project archive

aether project select