> ## 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={"dark"}
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={"dark"}
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={"dark"}
aether notification dismiss <id>
```

## Preferences

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

```bash theme={"dark"}
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`.


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