Notifications

Codemux has a notification and attention system that keeps you aware of what's happening across workspaces — especially useful when running multiple agents in parallel.

Desktop Notifications

When an agent needs attention, Codemux sends a desktop notification via the system notification daemon (D-Bus on Linux, native APIs on Windows / macOS). The notification:

• Shows "Codemux" as the title with the event message as the body
• Uses normal urgency so the notification daemon (mako, dunst, GNOME Shell, KDE Plasma, …) auto-dismisses it after the configured timeout. Critical urgency would keep popups stuck on screen until manually dismissed — reserved by those daemons for non-expiring system emergencies.
• Plays an optional notification sound (toggleable — see Sound below)
• Pops a "Codemux" desktop notification toast + chime when an off-screen agent finishes

Desktop notifications can be toggled in Settings → Notifications.

Window Focus

When a notification fires, Codemux automatically brings its window to the foreground:

• Unminimizes and focuses the window via Tauri
• On Hyprland, also runs hyprctl dispatch focuswindow class:com.codemux.app for reliable window activation

This means you don't have to manually find the Codemux window when an agent finishes or needs input.

Attention Badges

Each workspace in the sidebar shows a notification count badge when it has unread notifications. The count resets when you switch to that workspace.

This lets you scan the sidebar to see which workspaces have pending activity without clicking through each one.

Pane and Tab Status Indicators

Individual panes and tabs show colored status dots based on agent activity:

These appear in three places:

• Pane headers — Each pane shows its own status
• Tab bar — Each tab shows the highest-priority status from its panes
• Sidebar — Each workspace shows an aggregate status (permission > working > review > idle)

See Agent Status Indicators for the full details on how status tracking works.

Sending Notifications

Agents can send notifications programmatically:

codemux notify "Build finished successfully"

The MCP server also exposes a notify tool with an optional level parameter (info or attention).

Notification Sound

Notification sound playback is implemented on all three platforms:

Toggle it in Settings → Notifications → Notification sounds. The setting syncs across devices via your account.

Settings

Two notification settings are available in Settings → Notifications:

• Desktop notifications — Toggle system notification popups on/off
• Notification sounds — Toggle the audio chime on/off

Both settings sync across devices via your account.