Notifications and approvals

Superconductor surfaces agent state, completion, approval requests, and errors through in-app and macOS notifications.

Notification surfaces

Superconductor shows:

• A short in-app banner for quick confirmations.
• A richer in-app toast for errors and follow-up details.
• A macOS system notification for background agent events.
• Sidebar indicators for worktree-level agent state.

macOS notifications appear when the app is not frontmost.

Agent state

Superconductor infers agent state from provider hooks, managed wrappers, API-chat events, and local session lifecycle events. Depending on the provider, Superconductor shows an agent as:

• Idle.
• Working.
• Ready for review.
• Waiting for permission or input.

Completion, approval-needed, user-input-needed, and progress updates also produce notifications. Providers expose different lifecycle signals. Superconductor normalizes the signals it receives and avoids treating raw terminal text as authoritative protocol state.

Approval and input requests

Some providers ask before running commands, applying edits, or continuing through a risky step. When Superconductor receives a structured approval or input request, it surfaces that request in the relevant chat, terminal, toast, or system notification flow.

For approval requests:

1. Open the worktree that requested attention.
2. Read the command, tool action, or question.
3. Confirm that it matches the task and worktree.
4. Approve, deny, or answer from the provider surface.

macOS notification permissions

macOS controls whether Superconductor displays system notifications. If system notifications fail to appear:

1. Open macOS System Settings.
2. Go to Notifications.
3. Find Superconductor.
4. Enable notifications and choose your preferred banner behavior.

Superconductor also exposes app-level notification settings for delivery behavior and sounds.

Notification clicks

Clicking a notification returns you to the relevant worktree, tab, or request. If the worktree has moved or been deleted, the app falls back to the closest available context.

Tab titles help identify the session that opened from a notification:

sc tab title "Review Auth Agent"