Settings

Settings is where you configure projects, your account, and the Aether interface. The screen is a drill-down rail grouped into four sections. This guide covers the account-level tabs; per-project tabs are documented with projects, environment variables, and the AI agent.

Tabs

Group	Tab	What it controls
Projects	Runtime	Project hardware default (runtime class) and warm-start pool behavior.
	Task Defaults	Agent, model, and automation preferences new tasks inherit — see task defaults.
	PR Reviews	The prompt used when GitHub pull requests trigger review tasks.
	Environment Variables	Encrypted key/value pairs injected into each workspace — see environment variables.
	Secret Files	Encrypted files written to the workspace after clone.
	Project Skills	Folders of instructions and helper scripts agents can invoke.
Workspace	Warm Slots	Keep selected projects prewarmed for faster resume — see warm slots.
	Skills	Global skills available across your projects.
Account	Sign-in	Identity providers and the password for your account.
	Connections	Connect integrations and AI providers, and configure how they route into Aether.
	Notifications	How Aether reaches you when agents need input or finish — see notifications.
	API Keys	Generate and revoke platform API keys for programmatic access.
	Billing	Plan, monthly credits, credit packs, and payment details — see billing.
	Usage	Credits, VM runtime, and tokens across your workspaces — see usage.
Preferences	Appearance	How the Aether interface looks.

Account-level agent and hardware defaults

Agent, model, and hardware defaults live on the project, not the account — there is no single account-wide agent default. Set them per project:

Agent, model, mode, and automation under Settings → Projects → Task Defaults. See task defaults for the full list.
Hardware (the runtime class new workspaces start from) under Settings → Projects → Runtime.

New tasks inherit these defaults unless you override them in the composer.

Connections

The Connections tab is where you connect both integrations and AI provider accounts:

AI providers — connect your account for an agent provider (Codex, Claude Code, OpenCode, Cursor). A connected provider is required to run tasks; Codex is the default agent. See connect agent providers.
Integrations — connect GitHub, Linear, Slack, and Sentry, and configure how they route into Aether. See integrations.

Platform API keys for calling the Aether API are managed under the separate API Keys tab, not Connections.

Appearance

The Appearance tab sets the interface theme. Pick one of three options; your choice syncs across sessions.

Theme	Behavior
Light	Bright interface.
Dark	Low-contrast, easier on the eyes at night.
System	Follows your operating system preference.

Onboarding

New accounts are walked through a short onboarding flow before reaching Settings: sign in (OAuth, email, or CLI), connect GitHub and pick a repository, set environment variables, and connect an agent provider. Onboarding links the GitHub App and imports a repo so you can run your first task — see the quickstart.

Getting Started

Using Aether

Tabs

Account-level agent and hardware defaults

Connections

Appearance

Onboarding

​Tabs

​Account-level agent and hardware defaults

​Connections

​Appearance

​Onboarding

Tabs

Account-level agent and hardware defaults

Connections

Appearance

Onboarding