> ## 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 warm-slot

> List, assign, and release billing warm slots

# aether warm-slot

Manage warm slots — prewarmed machines reserved for a project at a specific VM size. The number of slots available is set by your [billing tier](/concepts/billing-and-credits).

**Alias:** `warm-slots`

## Usage

```bash theme={"dark"}
aether warm-slot <subcommand> [flags]
```

## Subcommands

| Subcommand | Description |
| - | - |
| `list` | List warm slots and their assignments |
| `assign` | Assign a project and size to a slot index |
| `release <slot-id>` | Release a slot |

## List

```bash theme={"dark"}
aether warm-slot list
```

Prints your tier, how many slots are allocated out of the maximum, and a row per slot showing its index, ID, assigned project, status, and last sync.

## Assign

```bash theme={"dark"}
aether warm-slot assign --slot 0 --project a1b2c3d4 --size large
```

| Flag | Description |
| - | - |
| `--slot` | Slot index (zero or greater; defaults to the lowest unassigned slot) |
| `--project` | Project ID or unique prefix |
| `--size` | Machine size: `small`, `medium`, or `large` (required) |

Each slot keeps one machine ready for its `(project, size)` pool. Assign more than one slot to the same project and size to keep more than one matching machine ready, or assign the project at several sizes to create separate pools.

`--project` and `--size` are required. The CLI does not choose a default size for a warm-slot assignment.

## Release

```bash theme={"dark"}
aether warm-slot release <slot-id>
```

Pass the slot ID from `aether warm-slot list`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.