More · System · Done badge · Notifications
Done badge · Notifications
When an AI agent running in another tab finishes its work, while that tab isn't visible the tab blinks a colored dingbat to let you know, and the top bell gathers the done and attention signals from every Space and tab in one place.
Done badge — inactive tabs
When you work across many tabs, it's easy to miss when an agent running in another tab (claude·codex·gemini·antigravity) finished. When a terminal tab you aren't looking at (inactive) receives a done signal, it blinks a colored dingbat next to the tab icon — green means the work is done, orange means it's waiting for approval or input. As soon as you look at that tab again, the badge disappears.
pwsh) has no badge.The same signal also blinks as a small bell next to the Space chip the tab belongs to, so even work that finished in another Space is shown together.
Per-agent support
An agent has two ways to announce completion — a simple terminal bell that almost any shell can send (it also rings on autocomplete and errors, so it has false positives, and since it can't tell done from approval it's always treated as green), and a precise signal that distinguishes done from approval by color and even carries the last prompt and response. The precise signal currently comes from running claude in its interactive screen.
Measured by running each CLI in a real dev-app terminal (2026-06, Windows).
| Agent | Precise color badge | Notes |
|---|---|---|
claude | ✓ Works | When run in the interactive screen, it distinguishes done from approval by color and preserves the content. Requires the claude-code-warp plugin installed and enabled — how to install. |
gemini | ✗ | Sends only a bell → just a done badge with no color distinction. |
antigravity | ✗ | Currently sends no badge signal. |
codex | Unverified | The bell works. |
Other agents, too, if you enable the terminal bell on completion option in each CLI, will get only a done badge via the bell fallback (no approval distinction, false positives possible).
Installing the claude notification plugin
claude's done and approval signals are sent not by claude itself but by the claude-code-warp plugin. Without it, claude tabs send no tab badges, Space-chip bells, or top-bell notifications at all — work finishing in another pane or Space shows nothing, so notifications look broken. Run these two lines once in a terminal.
$ claude plugin marketplace add warpdotdev/claude-code-warp$ claude plugin install warp@claude-code-warpclaude tabs that were already open before installing pick it up only after restarting claude. The environment variables the plugin needs (WARP_*) are added to every terminal automatically, so there's nothing else to set up.
!. Open the bell and the notice card at the top offers Run in terminal (types the command into a new terminal tab — just press Enter), Copy, Check again, and Don't show again. Once installed, the ! disappears the next time you open the bell. If the plugin is turned off, it suggests the enable command (claude plugin enable --scope user warp@claude-code-warp) instead. Computers that don't use claude (no ~/.claude folder) never show it.Unified notification center — the top bell
The bell in the top titlebar gathers the done and attention signals from every Space and tab in one place (main window only). By the same rule as the tab badges, it collects only done and waiting for approval/input, and a red number badge shows the total count.
Notifications are kept in memory only, so they clear when the app restarts, and they stack up to 100. Embedded popup windows have no bell; the main window aggregates everything.
Card contents
The card's last prompt and response (~20 chars each) are filled in only for agents that send the content along, like claude. When only a bell rang, there's no content, so it shows the Agent done placeholder.
Click a card → jump · delete
Clicking the card body switches to that Space, activates that tab, then clears the card. The tab name at the top of the card tells you which tab within the same Space.
| Action | Result |
|---|---|
| Click the card body | Switch to that Space + activate the tab → delete the card |
| Card X | Delete just that card without jumping |
| Header Clear all | Empty all cards at once |
| Red count badge | Current total card count |
Conversely, if you look at the tab directly without going through the card, that tab's badge and its bell card disappear together — you've already seen it, so there's no reason for the notification to linger. Flipping quickly through tabs doesn't close an open dropdown each time.