Notifications
Configure macOS delivery, sounds, pane attention, unread badges, terminal notifications, and tab-reorder haptics.
Supaterm can surface terminal and coding-agent activity in the sidebar, inside the pane, and through macOS.
System notifications
System notifications are off by default. Enable Settings > Notifications > System notifications to deliver terminal and agent notifications through macOS. The first enablement can trigger a macOS permission prompt.
If delivery is enabled but nothing appears, open System Settings > Notifications > Supaterm and verify macOS permission.
System notifications request the default macOS notification sound. macOS controls whether that sound plays.
Notification sounds
When system notifications are off, choose Settings > Notifications > Notification Sound to play a native macOS sound or Supaterm Classic without showing a system notification. Choosing a sound previews it. Never is the default.
Local sounds do not pass through Notification Center, so Focus does not silence them. Supaterm plays either a system notification or the selected local sound for an event, never both.
Set the same value from the command line:
sp config set notifications.sound supatermGlowing Pane Ring
Enable Glowing Pane Ring to highlight a pane when terminal or coding-agent activity needs attention.
Turning off the ring removes only the in-pane glow. Unread attention and sidebar badges remain.
Tab-reorder haptics
Enable Haptic feedback when reordering tabs to play feedback when a dragged tab enters a new drop target. The setting applies to local and incoming sidebar drags. It does not change drag motion.
Set the same value from the command line:
sp config set notifications.tab_move_haptics falseSidebar state
The sidebar can show an unread count, a bell, an agent-attention mark, and the latest notification preview. Focusing the relevant pane acknowledges its unread state.
Send a notification from a command
Inside Supaterm, notify the current pane:
sp pane notify --title "Build complete" --body "All checks passed"Pass a pane selector or UUID to notify another pane:
sp pane notify 1/2/3 --body "Deploy complete"Notification text may be visible on the lock screen according to macOS notification settings. Avoid putting secrets in titles or bodies.