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

> List, dismiss, and configure delivery of notifications

# aether notification

Manage notifications and how they're delivered to you.

**Alias:** `notifications`

## Usage

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

## Subcommands

| Subcommand        | Description                                           |
| ----------------- | ----------------------------------------------------- |
| `list`            | List notifications                                    |
| `dismiss <id>`    | Dismiss a notification                                |
| `preferences`     | Show delivery preferences (same as `preferences get`) |
| `preferences get` | Show delivery preferences                             |
| `preferences set` | Update one delivery preference                        |

## List

```bash theme={null}
aether notification list
aether notification list --status all --limit 50
```

| Flag       | Default  | Description                                                           |
| ---------- | -------- | --------------------------------------------------------------------- |
| `--status` | `active` | Status filter: `active`, `resolved`, `dismissed`, `archive`, or `all` |
| `--limit`  | `25`     | Maximum notifications to return                                       |
| `--before` | —        | Pagination cursor (the `Next cursor` from a previous page)            |

## Dismiss

```bash theme={null}
aether notification dismiss <id>
```

## Preferences

Each notification kind has independent email, Slack DM, and mobile push delivery toggles.

```bash theme={null}
aether notification preferences
aether notification preferences set --kind task_failed --email false
aether notification preferences set --kind question_requested --slack-dm true
aether notification preferences set --kind task_failed --push false
```

| Flag         | Description                                                                                                   |
| ------------ | ------------------------------------------------------------------------------------------------------------- |
| `--kind`     | Notification kind: `question_requested`, `plan_requested`, `task_response_ready`, or `task_failed` (required) |
| `--email`    | Enable or disable email delivery (`true`/`false`)                                                             |
| `--slack-dm` | Enable or disable Slack DM delivery (`true`/`false`)                                                          |
| `--push`     | Enable or disable mobile push delivery (`true`/`false`)                                                       |

`set` reads the existing preference first, then updates only the channels you pass. Provide at least one of `--email`, `--slack-dm`, or `--push`.