Skip to main content

​
aether workspace

Manage cloud workspaces. Each workspace is a full Linux VM with persistent storage where the agent runs your code. Aliases: workspaces, ws

​
Usage

aether workspace <subcommand> [flags]

​
Subcommands

SubcommandDescription
listList workspaces in the current project
get <id>Get workspace details
start <id>Start a stopped workspace
stop <id>Stop a running workspace
delete <id>Delete a workspace
ssh [workspace]Open an interactive SSH session

​
Workspace States

StateDescription
stoppedWorkspace is not running
startingWorkspace is booting up
runningWorkspace is active and accepting connections
stoppingWorkspace is shutting down
errorWorkspace encountered an error during state transition
stop_failedWorkspace failed to stop cleanly

​
aether workspace list

List all workspaces in the current project. 
aether workspace list [flags]
FlagDescription
--statusFilter by workspace state
aether workspace list

ID              STATUS      CREATED          MACHINE
ws_a1b2c3d4     running     2025-01-15       shared-cpu-1x
ws_e5f6g7h8     stopped     2025-01-10       shared-cpu-2x

aether workspace list --status running

​
aether workspace get

Get details for a specific workspace. 
aether workspace get <id>

aether workspace get ws_a1b2c3d4

ID:        ws_a1b2c3d4
Status:    running
Machine:   shared-cpu-1x
Region:    iad
Created:   2025-01-15T10:30:00Z
Preview:   https://ws-a1b2c3d4.runaether.dev

​
aether workspace start

Start a stopped workspace. 
aether workspace start <id> [flags]
FlagDescription
--no-waitReturn immediately without waiting for the workspace to reach running state
aether workspace start ws_a1b2c3d4

Starting workspace ws_a1b2c3d4...
Workspace is running.

aether workspace start ws_a1b2c3d4 --no-wait

Start requested for workspace ws_a1b2c3d4

​
aether workspace stop

Stop a running workspace. The workspace retains its persistent storage. 
aether workspace stop <id> [flags]
FlagDescription
--no-waitReturn immediately without waiting for the workspace to reach stopped state
aether workspace stop ws_a1b2c3d4

Stopping workspace ws_a1b2c3d4...
Workspace stopped.

​
aether workspace delete

Delete a workspace and its persistent storage. This action is irreversible. 
aether workspace delete <id> [flags]
FlagDescription
--forceSkip confirmation prompt
aether workspace delete ws_a1b2c3d4

Are you sure you want to delete workspace ws_a1b2c3d4? This will permanently remove all files. [y/N]

​
aether workspace ssh

Open an interactive terminal session in a running workspace. If no workspace ID is given, an interactive picker is displayed. 
aether workspace ssh [workspace]

# Interactive picker
aether workspace ssh

? Select a workspace:
> ws_a1b2c3d4 (running)
  ws_e5f6g7h8 (running)

# Connect directly
aether workspace ssh ws_a1b2c3d4

Connected to ws_a1b2c3d4
user@workspace:~$
Press Ctrl+D or type exit to disconnect.