The best way to control Claude Code, Codex and more from any computer or phone
feat(web): screen reader window title leads with the thread's status and name (#34697)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
shivam committed
Nov 12, 2026 at 17:45 UTC
1d218d1525bd051f61d0b2400508c8eff96fc811
9 files changed
+119
-5
apps/web/src/appInit.tsx
+11
-1
@@ -14,6 +14,7 @@ import { startElectronBrowserHost } from "./browser/ElectronBrowserHost";
14
import { startBrowserProfileReporting } from "./browser/BrowserProfileReporter";
15
import { startPreviewTitleRecording } from "./browserHistoryStore";
16
import { retainThreadOverlaysForThread } from "./components/chat/threadOverlayRetention";
17
+import { resolveWindowTitleThreadStatus } from "./components/Sidebar.logic";
18
import { startBackgroundThreadAnnouncements } from "./components/BackgroundThreadAnnouncer";
19
import { startSshPasswordPromptQueue } from "./components/desktop/SshPasswordPromptDialog";
20
import { startHostFreezeToasts } from "./components/HostFreezeToastCoordinator";
@@ -133,7 +134,10 @@ function readOpenThreadRef(router: AppRouter): ScopedThreadRef | null {
134
return resolveActiveThreadRouteRef(target, draft);
135
}
136
136
-/** Names the open thread and its project in the window title, or the app when none is open. */
137
+/**
138
+ * Names the open thread and its project in the window title, or the app when none is open.
139
+ * Screen readers read it on Alt+Tab, so it can lead with the thread and what it's doing.
140
+ */
141
function startDocumentTitle(router: AppRouter): void {
142
const readOnGuestPage = () => router.state.matches.some((match) => match.routeId === "/guest");
143
let openThreadRef = readOpenThreadRef(router);
@@ -163,6 +167,11 @@ function startDocumentTitle(router: AppRouter): void {
167
}),
168
projectTitle: project?.title ?? null,
169
threadTitle: thread?.title ?? null,
170
+ ...(getClientSettings().screenReaderWindowTitle && {
171
+ screenReader: {
172
+ threadStatus: thread === null ? null : resolveWindowTitleThreadStatus(thread),
173
+ },
174
+ }),
175
desktop: isElectron,
176
});
177
// Projects change whenever any project does; most changes leave the title alone.
@@ -198,6 +207,7 @@ function startDocumentTitle(router: AppRouter): void {
207
watchOpenThread();
208
appAtomRegistry.subscribe(primaryServerConfigAtom, write, { immediate: true });
209
appAtomRegistry.subscribe(environmentProjects.projectsAtom, write);
210
+ subscribeClientSettings(write);
211
router.subscribe("onResolved", updateOpenThread);
212
useComposerDraftStore.subscribe(updateOpenThread);
213
}
apps/web/src/branding.logic.ts
+12
-3
@@ -60,14 +60,23 @@ export function resolveWindowTitle(input: {
60
readonly appDisplayName: string;
61
readonly projectTitle: string | null;
62
readonly threadTitle: string | null;
63
+ /** The screen reader title: status, then thread, then project, since a screen reader reads from the start. */
64
+ readonly screenReader?: { readonly threadStatus: string | null };
65
readonly desktop: boolean;
66
}): string {
67
const threadTitle = input.threadTitle?.trim() ?? "";
68
+ const status = input.screenReader?.threadStatus;
69
if (threadTitle === "") {
67
- return input.appDisplayName;
70
+ return status ? `${status}: ${input.appDisplayName}` : input.appDisplayName;
71
}
72
73
const projectTitle = input.projectTitle?.trim() ?? "";
71
- const context = projectTitle === "" ? threadTitle : `${projectTitle} / ${threadTitle}`;
72
- return input.desktop ? context : `${context} - ${input.appDisplayName}`;
74
+ const context =
75
+ projectTitle === ""
76
+ ? threadTitle
77
+ : input.screenReader
78
+ ? `${threadTitle} - ${projectTitle}`
79
+ : `${projectTitle} / ${threadTitle}`;
80
+ const title = status ? `${status}: ${context}` : context;
81
+ return input.desktop ? title : `${title} - ${input.appDisplayName}`;
82
}
apps/web/src/components/Sidebar.logic.test.ts
+19
@@ -16,6 +16,7 @@ import {
16
resolveSidebarSweepKeys,
17
resolveSidebarThreadStatus,
18
resolveThreadStatusPill,
19
+ resolveWindowTitleThreadStatus,
20
resolveWorkingStartedAt,
21
searchSidebarThreads,
22
shouldRecedeSidebarThread,
@@ -310,6 +311,24 @@ describe("resolveSidebarThreadStatus", () => {
311
}),
312
).toBe("waiting");
313
});
314
+
315
+ it("titles the window with live work and requests only", () => {
316
+ const cases = [
317
+ [{ ...idle, hasPendingApprovals: true, runtime }, "Needs approval"],
318
+ [{ ...idle, hasPendingUserInput: true }, "Needs your input"],
319
+ [{ ...idle, runtime: { ...runtime, status: "preparing" as const } }, "Working"],
320
+ [{ ...idle, runtime }, "Working"],
321
+ [{ ...idle, runtime, pendingGuestMessageCount: 1 }, "Working"],
322
+ [{ ...idle, runtime, blockedOnThreadWait: true }, "Working"],
323
+ [{ ...idle, runtime: { ...runtime, status: "idle" as const } }, null],
324
+ [{ ...idle, runtime: { ...runtime, status: "failed" as const } }, null],
325
+ [{ ...idle, runtime: { ...runtime, status: "completed" as const } }, null],
326
+ [idle, null],
327
+ ] as const;
328
+ for (const [thread, title] of cases) {
329
+ expect(resolveWindowTitleThreadStatus(thread)).toBe(title);
330
+ }
331
+ });
332
});
333
334
describe("searchSidebarThreads", () => {
apps/web/src/components/Sidebar.logic.ts
+20
@@ -40,6 +40,7 @@ import {
40
import type { SidebarThreadSummary, Thread } from "../types";
41
import { normalizeSearchText } from "../lib/utils";
42
import { isLatestRunSettled } from "../session-logic";
43
+import { THREAD_STATUS_TEXT } from "@t3tools/client-runtime/state/thread-activity-announcement";
44
import { observeIntersection } from "../lib/observeIntersection";
45
import { deadlineAfter, deadlineStore, type ClockStore } from "@t3tools/client-runtime/clock";
46
import { useDeadlinePassed } from "../hooks/useDeadline";
@@ -990,6 +991,25 @@ export function resolveSidebarThreadStatus(thread: SidebarThreadStatusInput): Si
991
return "ready";
992
}
993
994
+/** What the window title says the open thread is doing, in the words its announcer uses. */
995
+export function resolveWindowTitleThreadStatus(thread: SidebarThreadStatusInput): string | null {
996
+ // A guest waiting doesn't hide that the agent is still working.
997
+ switch (resolveSidebarThreadStatus({ ...thread, pendingGuestMessageCount: 0 })) {
998
+ case "approval":
999
+ return THREAD_STATUS_TEXT.approval;
1000
+ case "input":
1001
+ return THREAD_STATUS_TEXT.input;
1002
+ case "preparing":
1003
+ case "working":
1004
+ return THREAD_STATUS_TEXT.working;
1005
+ case "waiting":
1006
+ // Waiting on a child thread is still this turn, so it must not read as finished.
1007
+ return thread.runtime?.status === "running" ? THREAD_STATUS_TEXT.working : null;
1008
+ default:
1009
+ return null;
1010
+ }
1011
+}
1012
+
1013
/**
1014
* The dot on a closed boring-sidebar folder: the most urgent state among its
1015
* hidden threads. Waiting threads stay quiet, like their rows.
apps/web/src/components/settings/SettingsPanels.tsx
+38
@@ -541,6 +541,9 @@ export function useSettingsRestore(onRestored?: () => void) {
541
...(settings.screenReaderAnnouncements !== DEFAULT_UNIFIED_SETTINGS.screenReaderAnnouncements
542
? ["Screen reader announcements"]
543
: []),
544
+ ...(settings.screenReaderWindowTitle !== DEFAULT_UNIFIED_SETTINGS.screenReaderWindowTitle
545
+ ? ["Screen reader window title"]
546
+ : []),
547
...(settings.responseStreamingMode !== DEFAULT_UNIFIED_SETTINGS.responseStreamingMode
548
? ["Response streaming"]
549
: []),
@@ -658,6 +661,7 @@ export function useSettingsRestore(onRestored?: () => void) {
661
followUpBehavior: DEFAULT_UNIFIED_SETTINGS.followUpBehavior,
662
toolCallVisibility: DEFAULT_UNIFIED_SETTINGS.toolCallVisibility,
663
screenReaderAnnouncements: DEFAULT_UNIFIED_SETTINGS.screenReaderAnnouncements,
664
+ screenReaderWindowTitle: DEFAULT_UNIFIED_SETTINGS.screenReaderWindowTitle,
665
environmentIdentificationMode: DEFAULT_UNIFIED_SETTINGS.environmentIdentificationMode,
666
glassOpacity: DEFAULT_UNIFIED_SETTINGS.glassOpacity,
667
panelAnimationDurationMs: DEFAULT_UNIFIED_SETTINGS.panelAnimationDurationMs,
@@ -1289,7 +1293,11 @@ export function ChatSettingsPanel() {
1293
1294
<SettingsSection id="activity" title="Activity">
1295
<ToolCallVisibilityRow />
1296
+ </SettingsSection>
1297
+
1298
+ <SettingsSection id="screen-reader" title="Screen reader">
1299
<ScreenReaderAnnouncementsRow />
1300
+ <ScreenReaderWindowTitleRow />
1301
</SettingsSection>
1302
</SettingsPageContainer>
1303
);
@@ -1403,6 +1411,36 @@ function ScreenReaderAnnouncementsRow() {
1411
);
1412
}
1413
1414
+function ScreenReaderWindowTitleRow() {
1415
+ const settings = useScopedSettings();
1416
+ const updateSettings = useUpdateScopedSettings();
1417
+ return (
1418
+ <SettingsRow
1419
+ {...searchableSetting("screen-reader-window-title")}
1420
+ description="Start the window title with the thread's status, like Needs approval, and its name, so screen readers read them first when you switch apps. Taskbars, shared screens, and time trackers see it too."
1421
+ resetAction={
1422
+ settings.screenReaderWindowTitle !== DEFAULT_UNIFIED_SETTINGS.screenReaderWindowTitle ? (
1423
+ <SettingResetButton
1424
+ label="screen reader window title"
1425
+ onClick={() =>
1426
+ updateSettings({
1427
+ screenReaderWindowTitle: DEFAULT_UNIFIED_SETTINGS.screenReaderWindowTitle,
1428
+ })
1429
+ }
1430
+ />
1431
+ ) : null
1432
+ }
1433
+ control={
1434
+ <Switch
1435
+ checked={settings.screenReaderWindowTitle}
1436
+ onCheckedChange={(checked) => updateSettings({ screenReaderWindowTitle: checked })}
1437
+ aria-label="Screen reader window title"
1438
+ />
1439
+ }
1440
+ />
1441
+ );
1442
+}
1443
+
1444
function DiffColorsSettingsRow() {
1445
const settings = useScopedSettings();
1446
const updateSettings = useUpdateScopedSettings();
apps/web/src/components/settings/settingsSearch.ts
+8
@@ -495,6 +495,14 @@ export const SETTINGS_SEARCH_ITEMS = [
495
"accessibility a11y screen reader nvda jaws voiceover orca narrator speech announce read aloud messages activity steps",
496
],
497
},
498
+ {
499
+ id: "screen-reader-window-title",
500
+ title: "Screen reader window title",
501
+ to: "/settings/chat",
502
+ searchTerms: [
503
+ "accessibility a11y screen reader nvda jaws voiceover orca narrator window title tab title alt tab taskbar thread status order working approval",
504
+ ],
505
+ },
506
{
507
id: "guest-links",
508
title: "Guest links",
docs/user/activity-log.md
+7
@@ -41,3 +41,10 @@ short. The reply that closes the turn is not read, so you can read it yourself w
41
are spaced out, so a quick step can be skipped for a newer one.
42
The agent's reasoning text is never read. The setting follows the agent's real activity, whatever
43
**Tool calls in chat** hides, and applies to this browser or device only.
44
+
45
+To hear the open thread and what it's doing when you switch to T3 Code, turn on **Screen reader
46
+window title** in the same section. The window title then starts with the thread's status
47
+(**Working**, **Needs approval**, or **Needs your input**) and its name, then the project, so a
48
+screen reader says them first. When the turn ends, only the status goes away.
49
+Anyone who can see your taskbar, window switcher, or shared screen sees it too, and time trackers
50
+that group by window title count each status separately.
packages/client-runtime/src/state/threadActivityAnnouncement.ts
+2
-1
@@ -5,6 +5,7 @@ export type ThreadActivityStatus = "working" | "approval" | "input" | "idle";
5
6
/** Background threads say these too, so a status sounds the same wherever it's heard. */
7
export const THREAD_STATUS_TEXT = {
8
+ working: "Working",
9
approval: "Needs approval",
10
input: "Needs your input",
11
done: "Done",
@@ -144,7 +145,7 @@ export function nextThreadAnnouncement(
145
? null
146
: THREAD_STATUS_TEXT.input
147
: turnStarted
147
- ? "Working"
148
+ ? THREAD_STATUS_TEXT.working
149
: null;
150
return { memory: { ...memory, turnRunId: nextTurnRunId }, announcement };
151
}
packages/contracts/src/settings.ts
+2
@@ -530,6 +530,7 @@ export const ClientSettingsSchema = Schema.Struct({
530
screenReaderAnnouncements: ScreenReaderAnnouncements.pipe(
531
Schema.withDecodingDefault(Effect.succeed("status" as const)),
532
),
533
+ screenReaderWindowTitle: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(false))),
534
// Retired Labs toggle. Still read as the default for the Usage item in threadDetailsItems.
535
threadDetailsUsageEnabled: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(false))),
536
// Sparse show/hide overrides for thread details card items. Missing ids use the client's
@@ -2054,6 +2055,7 @@ export const ClientSettingsPatch = Schema.Struct({
2055
boringSidebarMultilineRows: Schema.optionalKey(Schema.Boolean),
2056
toolCallVisibility: Schema.optionalKey(ToolCallVisibility),
2057
screenReaderAnnouncements: Schema.optionalKey(ScreenReaderAnnouncements),
2058
+ screenReaderWindowTitle: Schema.optionalKey(Schema.Boolean),
2059
threadDetailsUsageEnabled: Schema.optionalKey(Schema.Boolean),
2060
threadDetailsItems: Schema.optionalKey(Schema.Record(Schema.String, Schema.Boolean)),
2061
sidebarWorkingShelfEnabled: Schema.optionalKey(Schema.Boolean),