aether project

Manage your Aether projects. Projects contain workspaces, tasks, environment variables, and integration configurations.

Usage

aether project <subcommand> [flags]

Subcommand	Description
`list`	List all projects
`get <id>`	Get details for a specific project
`create`	Create a new project
`update <id>`	Update project metadata and runtime defaults
`delete <id>`	Delete a project
`select [id]`	Set the default project

List all projects in your account.

aether project list [flags]

Flag	Description
`--json`	Output as JSON

aether project list

ID              NAME            CREATED
proj_a1b2c3d4   my-app          2025-01-15
proj_e5f6g7h8   backend-api     2025-02-01

Get details for a specific project. Supports short ID prefix resolution (first 8 characters).

aether project get <id>

aether project get proj_a1b2

ID:          proj_a1b2c3d4
Name:        my-app
Description: Main application project
Created:     2025-01-15T10:30:00Z
Workspaces:  2

Create a new project.

aether project create [flags]

Flag	Description
`--name`	Project name (required)
`--description`	Project description
`--hardware-preset`	Default hardware preset
`--cpu-kind`	Default CPU kind
`--cpus`	Default CPU count
`--memory-mb`	Default memory in MB
`--volume-size-gb`	Default volume size in GB
`--gpu-kind`	Default GPU kind, or `none` to clear

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

Project created: proj_a1b2c3d4

Update project metadata, default workspace hardware, and task defaults.

aether project update <id> [flags]

Flag	Description
`--name`	Project name
`--description`	Project description
`--repo-url`	Repository URL
`--hardware-preset`	Default hardware preset
`--cpu-kind`	Default CPU kind
`--cpus`	Default CPU count
`--memory-mb`	Default memory in MB
`--volume-size-gb`	Default volume size in GB
`--gpu-kind`	Default GPU kind, or `none` to clear
`--agent-type`	Default task agent type
`--model`	Default task model
`--interaction-mode`	Default task interaction mode
`--reasoning-effort`	Default task reasoning effort, or `none`
`--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`)

Delete a project and all its resources. This action is irreversible.

aether project delete <id> [flags]

Flag	Description
`--force`	Skip confirmation prompt

aether project delete proj_a1b2c3d4

Are you sure you want to delete project "my-app"? This will delete all workspaces, tasks, and configuration. [y/N]

aether project delete proj_a1b2c3d4 --force

Set the default project for all CLI commands. If no ID is provided, an interactive picker is displayed.

aether project select [id]

# Interactive picker
aether project select

? Select a project:
> my-app (proj_a1b2c3d4)
  backend-api (proj_e5f6g7h8)

# Set directly
aether project select proj_a1b2c3d4

Default project set to: my-app (proj_a1b2c3d4)