<!-- GENERATED by scripts/build-docs.mjs from the live Commander tree (src/cli/program.ts). Do not edit by hand. -->

# pai notify

> Notification config: status, get, set, test, send

## Synopsis

```
pai notify <subcommand> [options]
```

## Subcommands

| Command | Description |
|---------|-------------|
| [`pai notify status`](#pai-notify-status) | Show current notification mode and active channels |
| [`pai notify get`](#pai-notify-get) | Show current notification config (alias for status) |
| [`pai notify set`](#pai-notify-set) | Update notification mode or channel configuration |
| [`pai notify test`](#pai-notify-test) | Send a test notification through configured channels |
| [`pai notify send <event> <message>`](#pai-notify-send-event-message) | Send a notification with an explicit event type and message |

### pai notify status

Show current notification mode and active channels


### pai notify get

Show current notification config (alias for status)


### pai notify set

Update notification mode or channel configuration

**Options**

| Option | Description | Default |
|--------|-------------|---------|
| `--mode <mode>` | Notification mode: auto \| voice \| whatsapp \| ntfy \| macos \| cli \| off |  |
| `--enable <channel...>` | Enable one or more channels |  |
| `--disable <channel...>` | Disable one or more channels |  |
| `--ntfy-url <url>` | Set the ntfy.sh topic URL |  |
| `--ntfy-priority <level>` | Set ntfy priority: min \| low \| default \| high \| urgent |  |
| `--whatsapp-recipient <contact>` | Set WhatsApp recipient |  |


### pai notify test

Send a test notification through configured channels

**Options**

| Option | Description | Default |
|--------|-------------|---------|
| `--event <event>` | Event type to test: error \| progress \| completion \| info \| debug | `info` |


### pai notify send <event> <message>

Send a notification with an explicit event type and message

**Arguments**

| Argument | Kind |
|----------|------|
| `<event>` | required |
| `<message>` | required |

**Options**

| Option | Description | Default |
|--------|-------------|---------|
| `--title <title>` | Optional notification title |  |


## See also

[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)

Run `pai help <area>` to read any of these in the terminal.