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

Alt+n 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.

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:

koshi actions run toggle-notification-center

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:

version 2

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

See koshi.kdl. With reduced-motion #true, the center and toasts appear and go in one frame.