# Agent Status & Notifications





## The Activity Strip [#the-activity-strip]

Each workspace in the sidebar shows an activity strip:

* **Running agents and open ports** appear inline on the workspace item
* **Running and PR state persist across restarts**
* Workspaces with live work are visually emphasized so in-progress items stand out
* Agent chips stay hidden unless multiple agents are running in that workspace

If a workspace shows as running after you've stopped its agent (for example after force-quitting the agent), use **Clear Status** on the workspace to reset the indicator.

## How Status Is Detected [#how-status-is-detected]

Superset installs lifecycle hooks and command wrappers into each agent's config (the entries in `~/.superset/bin` and files like `superset-hooks`). Those hooks report when an agent starts, finishes, or is waiting for input. That's why status only works for agents launched through Superset, and why removing the hooks disables status and notifications.

The hooks no-op outside Superset terminals (they check for a Superset-supplied env var). To remove them from an agent's config entirely, turn off the agent's **Superset hooks** toggle in **Settings → Agents**.

## Notifications [#notifications]

* **Finished / waiting for input**: get notified when an agent finishes or pauses for your input. Configure sounds in Settings.
* **Support varies by agent.** Claude Code reports both finished and waiting states. Some agents don't emit a waiting-for-input signal yet, so you'll only get completion notifications for them.
* **Inline prompts**: agents can pause to ask questions, request tool approval, or ask for plan review directly in the chat pane, and the workspace is flagged as needing attention.

## Dock Badge [#dock-badge]

The macOS dock icon shows a badge for workspaces with unread activity or that need your attention.

<img alt="Dock icon showing an attention badge" src="__img0" />

macOS only shows dock badges when Superset has notification permission. If you don't see badges, check **System Settings → Notifications → Superset**.