Notifications

Cogno collects events from your terminal sessions and surfaces them in the notification panel. The bell icon in the side menu shows a badge when new notifications have arrived. Opening the panel clears the badge.

Event types

Event	Config key
Long-running command finished	terminal.notifications.long_running_command.enabled
Handled application exception	notification.exception.handled.enabled
Unhandled renderer exception	notification.exception.unhandled.enabled
OSC 9 messages from shell scripts	terminal.notifications.osc9.enabled

Delivery channels

Notifications can be delivered in two ways:

Channel	Description	Config key
In-app	Panel inside Cogno, auto-dismisses after a timeout	notification.channel.app.enabled
OS	Native system notification (requires OS permission)	notification.channel.os.enabled

Configuration

Setting	Default	Description
feature.notification_overview.mode	visible	Initial panel visibility (off / hidden / visible)
feature.notification_overview.overview.max_items	30	Maximum notifications kept in the panel
terminal.notifications.unread_badge	true	Show an unread badge on a terminal’s tab when a notification-worthy event occurs while it isn’t focused
terminal.notifications.osc9.enabled	true	Notify on OSC 9 messages from shell scripts
terminal.notifications.long_running_command.enabled	false	Notify when a long-running command finishes
terminal.notifications.long_running_command.minimum_duration_seconds	10	Minimum runtime before a command is considered long-running
notification.exception.handled.enabled	false	Notify on handled exceptions
notification.exception.unhandled.enabled	false	Notify on unhandled renderer exceptions
notification.channel.app.enabled	true	Show in-app notifications
notification.channel.app.duration_seconds	5	Seconds before an in-app notification auto-dismisses
notification.channel.os.enabled	false	Send OS-level notifications

Action

Action	Description
open_notification	Toggle the notification panel