Notifications

Cogno tells you when something happens in a terminal you are not looking at, and keeps a list of those events so nothing gets lost.

Open the list with Ctrl+Alt+N (Command+Control+N on macOS).

What can notify you

Event	Turn it on with	Default
A long-running command finished	terminal.notifications.long_running_command.enabled	off
A program sent a message (OSC 9)	terminal.notifications.osc9.enabled	on
A coding agent changed state	the bell button in the Coding Agents panel	off
Cogno itself hit an error	notification.exception.handled.enabled, .unhandled.enabled	off

The most useful one to switch on is the first: start a build, work in another tab, and Cogno tells you when it is done.

terminal.notifications.long_running_command.enabled = true
terminal.notifications.long_running_command.minimum_duration_seconds = 30

The notification shows the command, how long it ran and its exit code. A failed command appears as a warning.

How you are notified

Channel	What you get	Default
In-app	A toast inside Cogno. At most 3 are shown at once.	on
Operating system	A native system notification. Clicking it opens the terminal it came from.	off

notification.channel.os.enabled = true
notification.channel.app.duration_seconds = 10

duration_seconds is how long a toast stays. unlimited keeps it until you dismiss it; 0 shows no toasts at all.

If the operating system denies permission, Cogno shows an in-app warning instead.

A terminal’s tab also gets an unread badge when something happens while it is not focused. Turn that off with terminal.notifications.unread_badge = false.

The list

The panel lists notifications newest first. Identical ones are merged into a single entry with a counter.

• Click an entry to jump to the workspace, tab and terminal it came from.
• Remove single entries, or empty the list with Clear.
• The bell icon in the side menu shows a badge while there are unread notifications.

The list keeps the 30 newest entries. Change that with feature.notification_overview.overview.max_items; unlimited keeps them all.

Settings

• terminal.notifications.* — which terminal events notify you
• notification.channel.* — the in-app and operating system channels
• notification.exception.* — notifications for Cogno’s own errors
• feature.notification_overview.* — the panel: mode = off removes it, order sets its side-menu position, overview.max_items its length

To open the panel with a different key, rebind open_notification, see Keybindings.