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

> Manage billing, credits, checkout, and portal sessions

# aether billing

Manage billing state from the CLI. Credits are Aether's usage unit — they track how long your workspace VMs run; LLM tokens are captured but never billed. See [billing and credits](/concepts/billing-and-credits).

## Usage

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

## Subcommands

| Subcommand                  | Description                                               |
| --------------------------- | --------------------------------------------------------- |
| `summary`                   | Show plan, credit balance, and warm slots                 |
| `catalog`                   | Show available tiers (price, monthly credits, warm slots) |
| `balance`                   | Show current credit balance and recent activity           |
| `subscription`              | Show subscription state                                   |
| `credit-packs`              | List available credit packs                               |
| `checkout`                  | Create a checkout session                                 |
| `portal`                    | Create a billing portal session                           |
| `checkout-status <session>` | Show checkout session status                              |

## Examples

```bash theme={null}
aether billing summary
aether billing balance --json
aether billing credit-packs
```

## Checkout

Create a checkout session for either a subscription tier or a one-time credit pack — pass exactly one of `--tier` or `--credit-pack`.

```bash theme={null}
aether billing checkout --tier pro
aether billing checkout --credit-pack credits_250
aether billing portal
```

| Flag            | Description                                   |
| --------------- | --------------------------------------------- |
| `--tier`        | Subscription tier: `starter`, `pro`, or `max` |
| `--credit-pack` | Credit pack ID (see below)                    |
| `--open`        | Open the checkout/portal URL in a browser     |

<Note>
  `--tier` and `--credit-pack` are mutually exclusive. Provide exactly one.
</Note>

### Credit pack IDs

| ID             | Credits |
| -------------- | ------- |
| `credits_100`  | 100     |
| `credits_250`  | 250     |
| `credits_500`  | 500     |
| `credits_1000` | 1000    |

Run `aether billing credit-packs` for the current list, prices, and checkout availability.

Checkout and portal commands print the URL by default. Pass `--open` to launch it in your browser; if the URL cannot be opened, the command fails.