Skip to main content
A workspace is the cloud VM that runs a task. Aether binds every task to exactly one agent and one workspace: when a task starts, its workspace boots, the agent works inside it, and the VM’s runtime is what your credits pay for. There is no standalone “create a workspace” screen in the web app. Workspaces come into being when you start a task or import a repository — see Entering a workspace.

​
Runtime Classes

Each workspace runs on a fixed runtime class. Runtime class sets the VM shape and credit rate, and comes from the size selected when its task is created. Every subscription tier can run all three classes. See pricing and tiers. Projects do not have a runtime-class default for tasks. Pick the task’s VM size in the web composer or with the CLI’s --size flag. See creating tasks.
GPU runtime classes are not available.

​
Workspace States

Aether surfaces these display states for a workspace:

​
Entering a Workspace

A workspace opens through its task. Start a task (or open an existing one) and Aether takes you to the workspace screen.If the workspace is stopped, the screen shows a Start environment gate — start it to bring back the file tree, terminal, and live agent. While the VM is stopping, the screen tells you to wait and start again once the stop finishes.

​
Stopping a Workspace

This shuts the VM down while preserving the persistent volume; files and installed packages survive the next start. Pass --no-wait to return without waiting for the stop to finish.

​
Idle Auto-Stop

A workspace that sits with no active task is automatically suspended or stopped after an idle period so it stops spending credits. Suspending snapshots the VM so the next task resumes quickly; stopping powers it off while keeping the volume. Resuming or restarting it picks up exactly where it left off.

​
Keep-Active

By default Aether reclaims idle workspaces. Set keep-active to keep a workspace running across idle periods:
A kept-active workspace keeps running, so it keeps spending credits until you turn keep-active off or stop it.

​
Listing Workspaces

Valid --status values include ready, idle, starting, preparing, stopped, suspended, and error.

​
Getting Workspace Details

Returns the full workspace object: display state, runtime class, hardware, project, and timestamps.

​
Updating VM Size

Valid sizes are small, medium, and large.

​
SSH Access

Open an interactive terminal in a workspace:
This targets the workspace of your selected project. The session gives you the same environment the agent uses.

​
Deleting a Workspace

Deleting a workspace destroys the VM and its persistent volume. All files, databases, and installed packages are permanently removed.