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

# aether settings

> View and set account-level agent and hardware defaults

# aether settings

Manage your account-level defaults — the agent, model, and workspace hardware that new [projects](/guides/projects) inherit when you don't override them. These are distinct from per-project [task defaults](/guides/projects#task-defaults); project settings take precedence over account settings.

## Usage

```bash theme={null}
aether settings <subcommand> [flags]
```

## Subcommands

| Subcommand | Description                   |
| ---------- | ----------------------------- |
| `get`      | Show current account defaults |
| `set`      | Update account defaults       |

## Get

```bash theme={null}
aether settings get
```

Prints your default agent, model, hardware, CPU kind, and storage size.

## Set

Provide at least one flag — only the settings you pass are changed. When you change any hardware flag, the unset hardware fields are preserved from your current defaults.

```bash theme={null}
aether settings set --agent-type codex --model gpt-5.5
aether settings set --cpu-kind performance --cpus 4 --memory-mb 16384 --volume-size-gb 20
```

| Flag               | Description                          |
| ------------------ | ------------------------------------ |
| `--agent-type`     | Default coding agent                 |
| `--model`          | Default model                        |
| `--cpu-kind`       | `shared` or `performance`            |
| `--cpus`           | Default CPU count                    |
| `--memory-mb`      | Default memory in MB                 |
| `--volume-size-gb` | Default volume size in GB            |
| `--gpu-kind`       | Default GPU kind, or `none` to clear |

For the list of selectable agents and models, see [agents and models](/concepts/agents-and-models).