feat: add completed-unseen badge states for tabs

gi11es · claude · gi11es · commit 064ec44b2281 · 2026-03-30T16:36:30.000+02:00
Add two new badge states (completedUnseen, terminalCompletedUnseen) that
show vivid colors when a Claude or terminal tab finishes work while the
user is looking at a different tab. The badge clears instantly when the
user visits the tab. Colors are configurable in Settings.

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/Sources/Detection/HookHandler.swift b/Sources/Detection/HookHandler.swift
@@ -22,9 +22,9 @@ class HookHandler {
             reply(ControlResponse(ok: true))
 
         case "hook.stop", "hook.stop-failure":
-            // Claude finished responding (or hit a limit/error) — waiting for user input
+            // Claude finished responding — mark as unseen if tab isn't focused
             if let surfaceId = message.surfaceId {
-                windowController?.updateBadge(forSurfaceId: surfaceId, state: .waitingForInput)
+                windowController?.updateBadgeToIdleOrUnseen(forSurfaceId: surfaceId, isClaude: true)
             }
             forwardRateLimits(from: message)
             reply(ControlResponse(ok: true))
@@ -35,7 +35,11 @@ class HookHandler {
                 if type.contains("permission") {
                     windowController?.updateBadge(forSurfaceId: surfaceId, state: .needsPermission)
                 } else {
-                    windowController?.updateBadge(forSurfaceId: surfaceId, state: .waitingForInput)
+                    // Don't overwrite completedUnseen — the tab hasn't been visited yet
+                    if let tab = windowController?.tabForSurfaceId(surfaceId),
+                       tab.badgeState != .completedUnseen {
+                        windowController?.updateBadge(forSurfaceId: surfaceId, state: .waitingForInput)
+                    }
                 }
             }
             reply(ControlResponse(ok: true))
diff --git a/Sources/Window/DeckardWindowController.swift b/Sources/Window/DeckardWindowController.swift
@@ -31,6 +31,8 @@ class TabItem {
         case terminalIdle     // muted teal - terminal at prompt
         case terminalActive   // teal pulsing - terminal foreground process has activity
         case terminalError    // red - terminal process exited with error
+        case completedUnseen        // vivid purple - Claude finished while tab unfocused
+        case terminalCompletedUnseen // vivid teal - terminal finished while tab unfocused
     }
 
     init(surface: TerminalSurface, name: String, isClaude: Bool) {
@@ -566,6 +568,7 @@ class DeckardWindowController: NSWindowController, NSSplitViewDelegate {
         } else {
             // Always clamp for safe array access, even during restore
             let safeIdx = max(0, min(project.selectedTabIndex, project.tabs.count - 1))
+            clearUnseenIfNeeded(project.tabs[safeIdx])
             showTab(project.tabs[safeIdx])
         }
 
@@ -747,15 +750,33 @@ class DeckardWindowController: NSWindowController, NSSplitViewDelegate {
             project.selectedTabIndex = min(idx, project.tabs.count - 1)
             rebuildTabBar()
             rebuildSidebar()
+            clearUnseenIfNeeded(project.tabs[project.selectedTabIndex])
             showTab(project.tabs[project.selectedTabIndex])
         }
         saveState()
     }
 
+    /// If the tab is in a completedUnseen state, revert to the normal idle state.
+    func clearUnseenIfNeeded(_ tab: TabItem) {
+        switch tab.badgeState {
+        case .completedUnseen:
+            tab.badgeState = .waitingForInput
+            rebuildSidebar()
+            rebuildTabBar()
+        case .terminalCompletedUnseen:
+            tab.badgeState = .terminalIdle
+            rebuildSidebar()
+            rebuildTabBar()
+        default:
+            break
+        }
+    }
+
     func selectTabInProject(at tabIndex: Int) {
         guard let project = currentProject else { return }
         guard tabIndex >= 0, tabIndex < project.tabs.count else { return }
         project.selectedTabIndex = tabIndex
+        clearUnseenIfNeeded(project.tabs[tabIndex])
         rebuildTabBar()
         showTab(project.tabs[tabIndex])
     }
@@ -768,6 +789,7 @@ class DeckardWindowController: NSWindowController, NSSplitViewDelegate {
         guard tabIndex >= 0, tabIndex < project.tabs.count else { return }
         guard tabIndex != project.selectedTabIndex else { return }
         project.selectedTabIndex = tabIndex
+        clearUnseenIfNeeded(project.tabs[tabIndex])
         showTab(project.tabs[tabIndex])
     }
 
@@ -915,7 +937,20 @@ class DeckardWindowController: NSWindowController, NSSplitViewDelegate {
                 terminalActiveStreak[tab.id] = newStreak
                 let confirmedActive = newStreak >= 2
 
-                let newBadge: TabItem.BadgeState = confirmedActive ? .terminalActive : .terminalIdle
+                let newBadge: TabItem.BadgeState
+                if confirmedActive {
+                    newBadge = .terminalActive
+                } else if tab.badgeState == .terminalActive {
+                    // Transitioning from active to idle — check focus
+                    let focused = isTabFocused(tab.id.uuidString)
+                    newBadge = focused ? .terminalIdle : .terminalCompletedUnseen
+                } else if tab.badgeState == .terminalCompletedUnseen {
+                    // Stay unseen until tab is visited (cleared elsewhere)
+                    newBadge = .terminalCompletedUnseen
+                } else {
+                    newBadge = .terminalIdle
+                }
+
                 terminalActivity[tab.id] = activity
                 if tab.badgeState != newBadge {
                     if newBadge == .terminalActive {
@@ -1049,6 +1084,24 @@ class DeckardWindowController: NSWindowController, NSSplitViewDelegate {
         rebuildTabBar()
     }
 
+    /// Like updateBadge, but substitutes completedUnseen/terminalCompletedUnseen
+    /// when the tab transitions to an idle state while unfocused.
+    func updateBadgeToIdleOrUnseen(forSurfaceId surfaceIdStr: String, isClaude: Bool) {
+        guard let tab = tabForSurfaceId(surfaceIdStr) else { return }
+        let wasBusy = isClaude
+            ? (tab.badgeState == .thinking || tab.badgeState == .needsPermission)
+            : (tab.badgeState == .terminalActive)
+        let focused = isTabFocused(surfaceIdStr)
+        let idleState: TabItem.BadgeState = isClaude ? .waitingForInput : .terminalIdle
+        let unseenState: TabItem.BadgeState = isClaude ? .completedUnseen : .terminalCompletedUnseen
+        let newState = (wasBusy && !focused) ? unseenState : idleState
+        DiagnosticLog.shared.log("badge",
+            "updateBadgeToIdleOrUnseen: surfaceId=\(surfaceIdStr) wasBusy=\(wasBusy) focused=\(focused) -> \(newState)")
+        tab.badgeState = newState
+        rebuildSidebar()
+        rebuildTabBar()
+    }
+
     func listTabInfo() -> [TabInfo] {
         var result: [TabInfo] = []
         for project in projects {
diff --git a/Sources/Window/SettingsWindow.swift b/Sources/Window/SettingsWindow.swift
@@ -687,12 +687,14 @@ class SettingsWindowController: NSWindowController, NSToolbarDelegate, NSTextFie
         (.waitingForInput, "Ready"),
         (.needsPermission, "Needs Permission"),
         (.error, "Error"),
+        (.completedUnseen, "Done (Unvisited)"),
     ]
 
     private static let terminalBadgeEntries: [(state: TabItem.BadgeState, label: String)] = [
         (.terminalIdle, "Idle"),
         (.terminalActive, "Busy"),
         (.terminalError, "Error"),
+        (.terminalCompletedUnseen, "Done (Unvisited)"),
     ]
 
     /// Default animation settings per state.
diff --git a/Sources/Window/SidebarViews.swift b/Sources/Window/SidebarViews.swift
@@ -154,6 +154,8 @@ class VerticalTabRowView: NSView, NSTextFieldDelegate, NSDraggingSource {
         case .terminalIdle: return "Idle"
         case .terminalActive: return activity?.description ?? "Running"
         case .terminalError: return "Error"
+        case .completedUnseen: return "Done (unvisited)"
+        case .terminalCompletedUnseen: return "Done (unvisited)"
         }
     }
 
@@ -166,6 +168,8 @@ class VerticalTabRowView: NSView, NSTextFieldDelegate, NSDraggingSource {
         .terminalIdle: NSColor(red: 0.35, green: 0.55, blue: 0.54, alpha: 1.0),
         .terminalActive: NSColor(red: 0.45, green: 0.72, blue: 0.71, alpha: 1.0),
         .terminalError: NSColor(red: 0.85, green: 0.3, blue: 0.3, alpha: 1.0),
+        .completedUnseen: NSColor(red: 0.95, green: 0.4, blue: 0.7, alpha: 1.0),
+        .terminalCompletedUnseen: NSColor(red: 0.3, green: 0.75, blue: 0.73, alpha: 1.0),
     ]
 
     static func colorForBadge(_ state: TabItem.BadgeState) -> NSColor {
diff --git a/Sources/Window/TabBarController.swift b/Sources/Window/TabBarController.swift
@@ -145,6 +145,7 @@ extension DeckardWindowController {
             project.selectedTabIndex = min(idx, project.tabs.count - 1)
             rebuildTabBar()
             rebuildSidebar()
+            clearUnseenIfNeeded(project.tabs[project.selectedTabIndex])
             showTab(project.tabs[project.selectedTabIndex])
         }
         saveState()

Original file line number	Diff line number	Diff line change
`@@ -687,12 +687,14 @@ class SettingsWindowController: NSWindowController, NSToolbarDelegate, NSTextFie`
`687`	`687`	`(.waitingForInput, "Ready"),`
`688`	`688`	`(.needsPermission, "Needs Permission"),`
`689`	`689`	`(.error, "Error"),`
	`690`	`+ (.completedUnseen, "Done (Unvisited)"),`
`690`	`691`	`]`
`691`	`692`
`692`	`693`	`private static let terminalBadgeEntries: [(state: TabItem.BadgeState, label: String)] = [`
`693`	`694`	`(.terminalIdle, "Idle"),`
`694`	`695`	`(.terminalActive, "Busy"),`
`695`	`696`	`(.terminalError, "Error"),`
	`697`	`+ (.terminalCompletedUnseen, "Done (Unvisited)"),`
`696`	`698`	`]`
`697`	`699`
`698`	`700`	`/// Default animation settings per state.`
Original file line number	Diff line number	Diff line change
`@@ -154,6 +154,8 @@ class VerticalTabRowView: NSView, NSTextFieldDelegate, NSDraggingSource {`
`154`	`154`	`case .terminalIdle: return "Idle"`
`155`	`155`	`case .terminalActive: return activity?.description ?? "Running"`
`156`	`156`	`case .terminalError: return "Error"`
	`157`	`+ case .completedUnseen: return "Done (unvisited)"`
	`158`	`+ case .terminalCompletedUnseen: return "Done (unvisited)"`
`157`	`159`	`}`
`158`	`160`	`}`
`159`	`161`
`@@ -166,6 +168,8 @@ class VerticalTabRowView: NSView, NSTextFieldDelegate, NSDraggingSource {`
`166`	`168`	`.terminalIdle: NSColor(red: 0.35, green: 0.55, blue: 0.54, alpha: 1.0),`
`167`	`169`	`.terminalActive: NSColor(red: 0.45, green: 0.72, blue: 0.71, alpha: 1.0),`
`168`	`170`	`.terminalError: NSColor(red: 0.85, green: 0.3, blue: 0.3, alpha: 1.0),`
	`171`	`+ .completedUnseen: NSColor(red: 0.95, green: 0.4, blue: 0.7, alpha: 1.0),`
	`172`	`+ .terminalCompletedUnseen: NSColor(red: 0.3, green: 0.75, blue: 0.73, alpha: 1.0),`
`169`	`173`	`]`
`170`	`174`
`171`	`175`	`static func colorForBadge(_ state: TabItem.BadgeState) -> NSColor {`
Original file line number	Diff line number	Diff line change
`@@ -145,6 +145,7 @@ extension DeckardWindowController {`
`145`	`145`	`project.selectedTabIndex = min(idx, project.tabs.count - 1)`
`146`	`146`	`rebuildTabBar()`
`147`	`147`	`rebuildSidebar()`
	`148`	`+ clearUnseenIfNeeded(project.tabs[project.selectedTabIndex])`
`148`	`149`	`showTab(project.tabs[project.selectedTabIndex])`
`149`	`150`	`}`
`150`	`151`	`saveState()`