Repository navigation
Personal build: keep unread completion counts on the app icon until threads are viewed #3
Description
Personal-build change
Keep a numeric app-icon badge for completed, unread top-level threads until each corresponding thread is viewed, like Codex. Focusing T3 alone must not acknowledge other threads. This is a personal fork patch layered onto the existing notification feature.
Expected behavior
- Five completed unread threads show 5; viewing one reduces the count to 4.
- Count is derived from existing completion/read state across connected environments, including on startup/reconnect, rather than transient notification delivery.
- New work, read acknowledgement, settlement, snooze, archive, deletion and environment removal update the count consistently; hidden child threads are not counted separately.
- Preserve existing sounds, popups and attention notifications; deduplicate any notification and unread-completion contribution for the same thread.
- Desktop native badge and web favicon share the behavior. Mobile native badging is outside this desktop/web personal patch.
- Focused regression tests cover focus retention, per-thread acknowledgement and lifecycle changes.
Analysed upstream references
- [Feature]: Dock badge and bounce when a turn finishes while the app is hidden pingdotgg/t3code#9615 — original request for unread thread Dock counts, cleared per visited thread.
- feat(desktop): show unread completion badges pingdotgg/t3code#11040 — implemented unread completion badges; closed in favor of feat: badge background thread notifications on desktop and web pingdotgg/t3code#11569, without merge.
- feat(desktop): show unread completion badges pingdotgg/t3code#11040 (comment) — closure explicitly chose notification-based counts and app-focus clearing.
- feat: badge background thread notifications on desktop and web pingdotgg/t3code#11569 — merged desktop/web notification badge implementation; clears on app focus.
- macOS Dock badge clears on app focus while threads still need attention pingdotgg/t3code#21911 — complaint that focus clears reminders for unreviewed threads.
- macOS Dock badge clears on app focus while threads still need attention pingdotgg/t3code#21911 (comment) — upstream confirmed current behavior is intentional; alternatives belong in Ideas.
- Always-visible thread tally per project (in-app strip + tray) pingdotgg/t3code#21703 — persistent thread tallies, including completed unread threads, without focus clearing.
- MOBILE APP: Please allow an option for badged icon to show number of threads needing attention pingdotgg/t3code#22955 — related mobile app-icon attention-count proposal.
The separate pending-question visibility bug (pingdotgg#25806 / pingdotgg#26435) is background context and is not part of this patch.
Activity
iXab3r commentedon Oct 31, 2026
Implemented in commit 8a145e9bcd on branch
bugfix/persistent-unread-completion-badge.The desktop native icon and web favicon now combine persistent completed-unread threads with the existing background-notification count, deduplicating each thread. App focus still acknowledges transient notifications, while unread completions remain until their corresponding visit watermark advances. The count is reconstructed from connected environment snapshots, works with notifications disabled or permission denied, includes never-opened completions, and respects the local visit fallback for older servers. Restarted, archived, deleted, settled, snoozed and hidden child threads leave the completion count.
Verification:
vp test run apps/web/src/components/ThreadNotificationCoordinator.badge.browser.test.ts apps/desktop/src/ipc/methods/notificationBadge.test.ts apps/web/src/components/ThreadNotificationCoordinator.logic.test.ts. Covers independent per-thread acknowledgements, focus retention, multiple environments, notification deduplication, permission/settings independence, lifecycle changes, unvisited completions and legacy local visits.vp test run apps/web/src/reactCompilerCoverage.test.ts -t ThreadNotificationCoordinator.git diff --checkpass. The commit hook also passed the repository'sknip:check.check:changed HEADitself could not spawnvpchild commands through this Windows installation'svp.cmd; its relevant checks were run directly instead.Scope: renderer logic shared by web/desktop and Electron's Windows/macOS/Linux badge handlers. Provider protocols, server contracts and native mobile behavior are unchanged. Chromium coordinator tests ran in a real headless browser; Electron platform dispatch/focus tests use mocked native APIs. A full application UI pass and native taskbar/Dock placement were not verified. No installer or personal release has been built or installed yet.
The branch is pushed and ready to integrate into the personal build. Keeping this issue open until that integration/release.
Model: GPT-6.1 Sol, high reasoning effort. Harness: Codex in T3 Code.
feat(client): keep unread completion badges until threads are viewed
feat(client): keep unread completion badges until threads are viewed
iXab3r commentedon Oct 31, 2026
Merged into personal via #4 (merge commit 50e2ac8). Rebased onto the latest personal branch, retained the reconnect notification fix, and added coverage for unread counts through cached state. Author source review found no blocking issues; 34 focused tests, scoped typechecks and the other documented local checks passed. This records source integration; a new packaged personal release and native taskbar placement have not been verified here.