Skip to main content
A workspace is the cloud VM where Aether’s agent runs your code. Every task is bound to exactly one workspace, and each workspace is a full Ubuntu Linux machine with persistent storage, a real terminal, and a real browser. Your source code, dependencies, and dev servers live here and persist across tasks — the workspace is not a stateless sandbox that resets between prompts.

​
Display States

A workspace reports its current condition as a display state. These are the values you see in the web app, the CLI, and the API:
The CLI aether workspace list --status filter accepts any of these display states, and you can pass several comma-separated (for example --status ready,error).

​
Runtime Classes

Hardware is not free-form. You choose from four fixed runtime classes, each with a fixed CPU/memory/storage shape and a per-hour credit rate. performance is an alias for large. The default runtime class is medium. Which classes you may use depends on your subscription tier — the Free tier is limited to small and medium, while paid tiers allow all four. See pricing and tiers. Runtime class drives billing: a workspace consumes its class’s credits/hour for the time it is active. At 10 credits/hour, one credit buys roughly 6 minutes of medium VM time.

​
Idle Auto-Stop

Workspaces stop themselves when nothing is using them, so you do not pay for idle VM time. While a task is running, a background activity is in flight, or you have an interactive connection open (terminal, file browser, preview), the workspace is held active. When those release, the workspace signals idle and is suspended. An interactive disconnect (a closed browser tab, a brief network blip) keeps a short reconnect grace before the workspace is considered idle. To keep a specific workspace from auto-stopping, opt it out:
Set it back to false to re-enable auto-stop.

​
Preinstalled Toolchain

The workspace base image is Ubuntu 22.04. It ships the agent CLIs (Codex, Claude Code, Cursor) plus a broad toolchain so the agent can build and test most projects without installing a runtime first:
  • Languages and runtimes: Go 1.26.4, Rust (stable), Node.js 20 with pnpm, Bun 1.3.13, Python 3.11
  • Containers: Docker CE and the Docker Compose plugin
  • Git tooling: git and the GitHub CLI (gh)
  • Search and shell utilities: ripgrep, fd, bat, jq, tree, tmux
  • Browser automation: Playwright with Chromium
  • GUI / computer-use: Xvfb, xdotool, ffmpeg (screen recording)
You run as the coder user with passwordless sudo. SSH listens on port 2222 and the agent service on port 3001. To install anything else your project needs at startup, use .aether/environment.json.

Warm Slots

Pre-provisioned snapshots that start workspaces faster.

Billing & Credits

How VM runtime is metered in credits.

Agents & Models

The providers and models that run inside a workspace.

environment.json

Configure setup commands and background services.