> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewship.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Notification Commands

> List, read, and delete in-app notifications for the current user.

# crewship notification

Manage per-user notifications. Notifications are emitted when an issue
is assigned to you, a mission you're part of changes state, an
escalation is raised on your crew, and similar events.

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

## Subcommands

| Command    | Description                              |
| ---------- | ---------------------------------------- |
| `list`     | List notifications for the current user. |
| `count`    | Show the number of unread notifications. |
| `read`     | Mark a single notification as read.      |
| `read-all` | Mark every notification as read.         |
| `delete`   | Delete a notification.                   |

***

## `crewship notification list`

```bash theme={null}
crewship notification list
crewship notification list --unread
crewship notification list --limit 20
```

| Flag       | Type   | Default            | Description                                                    |
| ---------- | ------ | ------------------ | -------------------------------------------------------------- |
| `--unread` | `bool` | `false`            | Show only unread notifications.                                |
| `--limit`  | `int`  | *(server default)* | Maximum number of rows to return. `0` uses the server default. |

***

## `crewship notification count`

Return the number of unread notifications for the current user — used
as a status-bar ping in scripts.

```bash theme={null}
crewship notification count
```

***

## `crewship notification read`

Mark one notification as read.

```bash theme={null}
crewship notification read <id>
```

***

## `crewship notification read-all`

Mark every notification for the current user as read.

```bash theme={null}
crewship notification read-all
```

***

## `crewship notification delete`

Delete a single notification. The action is immediate — there is no
confirmation prompt — so wrap in `--dry-run` upstream tooling if you
need a check before commit.

```bash theme={null}
crewship notification delete <id>
crewship notification delete <id>  # alias: remove, rm
```

Aliases: `remove`, `rm`.