Skip to main content

​
aether project

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

​
Usage

aether project <subcommand> [flags]

​
Subcommands

SubcommandDescription
listList all projects
get <id>Get details for a specific project
createCreate a new project
delete <id>Delete a project
select [id]Set the default project

​
aether project list

List all projects in your account. 
aether project list [flags]
FlagDescription
--jsonOutput as JSON
aether project list

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

​
aether project get

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

​
aether project create

Create a new project. 
aether project create [flags]
FlagDescription
--nameProject name (required)
--descriptionProject description
aether project create --name "my-app" --description "Main application"

Project created: proj_a1b2c3d4

​
aether project delete

Delete a project and all its resources. This action is irreversible. 
aether project delete <id> [flags]
FlagDescription
--forceSkip 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

​
aether project select

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)