> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings

> The Settings screen: project defaults, connections, billing, appearance, and account preferences.

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](/guides/projects), [environment variables](/guides/environment-variables), and the [AI agent](/guides/agents-and-models).

## Tabs

| Group           | Tab                   | What it controls                                                                                                     |
| --------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Projects**    | Runtime               | Project hardware default ([runtime class](/concepts/pricing-and-tiers)) and warm-start pool behavior.                |
|                 | Task Defaults         | Agent, model, and automation preferences new tasks inherit — see [task defaults](/guides/projects).                  |
|                 | 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](/guides/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](/concepts/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](/guides/notifications).                |
|                 | API Keys              | Generate and revoke platform API keys for [programmatic access](/api-reference/authentication).                      |
|                 | Billing               | Plan, monthly credits, credit packs, and payment details — see [billing](/guides/billing).                           |
|                 | Usage                 | Credits, VM runtime, and tokens across your workspaces — see [usage](/guides/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](/guides/projects) for the full list.
* **Hardware** (the [runtime class](/concepts/pricing-and-tiers) 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](/concepts/agents-and-models) (Codex, Claude Code, OpenCode, Cursor). A connected provider is required to run tasks; Codex is the default agent. See [connect agent providers](/guides/connect-agent-providers).
* **Integrations** — connect GitHub, Linear, Slack, and Sentry, and configure how they route into Aether. See [integrations](/concepts/integrations).

<Note>
  Platform API keys for calling the Aether API are managed under the separate **API Keys** tab, not Connections.
</Note>

## 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](/guides/github-integration) and imports a repo so you can run your first task — see the [quickstart](/quickstart).