# Koshi 0.6.0 — Notifications (/docs/v0.6/using/notifications)



koshi states each message of its own as a notification: a pane that a signal
killed, a config warning, or a key whose command the session refused. A toast
shows each new one for a short time, and the notification center keeps them.

Notifications belong to your terminal. Another terminal on the same session
keeps its own list, and clearing yours removes nothing from it.

## The button [#the-button]

The tab bar shows the notification button `●` left of the tray button. With
unread notifications it shows their count, such as `●3`, and `●99+` above 99.
A notification is read once the center opens after it arrives.

## The notification center [#the-notification-center]

<kbd>Alt+n</kbd> or a click on the button opens the center on the right side
of the pane area. It lists one card per notification, newest first, each with
a header such as `[Koshi] Error` above its text. A notification that repeats
shows its count: `[Koshi] Warning ×3`.

While the center is open, the tab bar reads `NOTIFICATIONS` and no key reaches
a pane.

| Keys                               | Result                                        |
| ---------------------------------- | --------------------------------------------- |
| <kbd>↑</kbd> / <kbd>↓</kbd>        | Select a newer / older card                   |
| <kbd>x</kbd>                       | Dismiss the selected notification             |
| <kbd>c</kbd>                       | Clear every notification and close the center |
| <kbd>Esc</kbd> or <kbd>Alt+n</kbd> | Close the center; every notification stays    |

With the mouse, a click on a card selects it, its `✕` dismisses it, `Clear all`
clears every notification, and the wheel scrolls the list. A click outside the
center closes it.

The center does not open while another mode such as the move preview is on,
while the link to a remote session is lost, or when the pane area is narrower
than 10 columns or shorter than 6 rows. It and the floating pane tray are never
open together.

From a shell:

```bash
koshi actions run toggle-notification-center
```

## Toasts [#toasts]

A toast slides in at the top right of the pane area, stays 3 seconds, and
slides out. At most 3 notifications wait for a toast; further ones join one
last toast that counts them, such as `36 more notifications in the center`.
A click on a toast's `✕` slides it out, and its notification stays in the
center. Opening the center removes every toast, and a notification that arrives
while the center is open shows no toast.

The `notifications` block of `koshi.kdl` moves toasts, changes how long they
stay, or turns them off:

```kdl title="koshi.kdl"
version 2

notifications {
    toast #true
    toast-position "bottom-left"
    toast-duration-ms 5000
}
```

See [koshi.kdl](/docs/v0.6/configuration/koshi-kdl#notifications). With
`reduced-motion #true`, the center and toasts appear and go in one frame.