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	General	Project name, repository, and archive controls.
	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 machines prewarmed for selected project-and-size pairs — see warm slots.
	Skills	Global skills available across your projects.
Account	Sign-in	Identity providers and email-code sign-in 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.

Agent defaults

Agent and model 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. New tasks inherit the task defaults unless you override them in the composer. VM size is always selected at task creation; projects and accounts do not carry a hardware default.

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). 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

Agent defaults

Connections

Appearance

Onboarding

​Tabs

​Agent defaults

​Connections

​Appearance

​Onboarding

Tabs

Agent defaults

Connections

Appearance

Onboarding