feat(tui): show busy/idle progress indicator in terminal title

packages/tui/src/app.tsx

@@ -59,7 +59,7 @@ import { PromptStashProvider } from "./component/prompt/stash"
 import { DialogAlert } from "./ui/dialog-alert"
 import { DialogConfirm } from "./ui/dialog-confirm"
 import { ToastProvider, useToast } from "./ui/toast"
-import { isDefaultTitle } from "./util/session"
+import { isDefaultTitle, titleStatusGlyph } from "./util/session"
 import { KVProvider, useKV } from "./context/kv"
 import * as Model from "./util/model"
 import { ArgsProvider, useArgs, type Args } from "./context/args"
@@ -445,6 +445,7 @@ function App(props: { onSnapshot?: () => Promise<string[]>; pluginHost: TuiPlugi
     renderer.clearSelection()
   }
   const [terminalTitleEnabled, setTerminalTitleEnabled] = createSignal(kv.get("terminal_title_enabled", true))
+  const [titleSpinnerFrame, setTitleSpinnerFrame] = createSignal(0)
   const [pasteSummaryEnabled, setPasteSummaryEnabled] = createSignal(
     kv.get("paste_summary_enabled", !sync.data.config.experimental?.disable_paste_summary),
   )
@@ -459,14 +460,15 @@ function App(props: { onSnapshot?: () => Promise<string[]>; pluginHost: TuiPlugi
     }
 
     if (route.data.type === "session") {
+      const glyph = titleStatusGlyph(sync.data.session_status?.[route.data.sessionID], titleSpinnerFrame())
       const session = sync.session.get(route.data.sessionID)
       if (!session || isDefaultTitle(session.title)) {
-        renderer.setTerminalTitle("DCode")
+        renderer.setTerminalTitle(`DC ${glyph}`)
         return
       }
 
       const title = session.title.length > 40 ? session.title.slice(0, 37) + "..." : session.title
-      renderer.setTerminalTitle(`DC | ${title}`)
+      renderer.setTerminalTitle(`DC ${glyph} | ${title}`)
       return
     }
 
@@ -475,6 +477,16 @@ function App(props: { onSnapshot?: () => Promise<string[]>; pluginHost: TuiPlugi
     }
   })
 
+  // Animate the busy glyph in the terminal title while the current session is working
+  createEffect(() => {
+    if (!terminalTitleEnabled() || Flag.OPENCODE_DISABLE_TERMINAL_TITLE) return
+    if (route.data.type !== "session") return
+    const status = sync.data.session_status?.[route.data.sessionID]
+    if (status?.type !== "busy" && status?.type !== "retry") return
+    const interval = setInterval(() => setTitleSpinnerFrame((frame) => frame + 1), 500)
+    onCleanup(() => clearInterval(interval))
+  })
+
   const args = useArgs()
   onMount(() => {
     batch(() => {

packages/tui/src/util/session.ts

@@ -1,3 +1,13 @@
+import type { SessionStatus } from "@opencode-ai/sdk/v2"
+
 export function isDefaultTitle(title: string) {
   return /^(New session - |Child session - )\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(title)
 }
+
+const TITLE_SPINNER_FRAMES = ["· ", " ·"] as const
+
+export function titleStatusGlyph(status: SessionStatus | undefined, frame = 0) {
+  if (status?.type === "busy" || status?.type === "retry")
+    return TITLE_SPINNER_FRAMES[frame % TITLE_SPINNER_FRAMES.length]
+  return "*"
+}

packages/tui/test/util/session.test.ts

@@ -1,10 +1,23 @@
 import { describe, expect, test } from "bun:test"
-import { isDefaultTitle } from "../../src/util/session"
+import { isDefaultTitle, titleStatusGlyph } from "../../src/util/session"
 
 describe("util.session", () => {
   test("recognizes generated parent and child titles", () => {
     expect(isDefaultTitle("New session - 2026-06-06T12:34:56.789Z")).toBeTrue()
     expect(isDefaultTitle("Child session - 2026-06-06T12:34:56.789Z")).toBeTrue()
     expect(isDefaultTitle("New session - custom")).toBeFalse()
   })
+
+  test("animates the busy glyph between spinner frames", () => {
+    expect(titleStatusGlyph({ type: "busy" }, 0)).toBe("· ")
+    expect(titleStatusGlyph({ type: "busy" }, 1)).toBe(" ·")
+    expect(titleStatusGlyph({ type: "busy" }, 2)).toBe("· ")
+    expect(titleStatusGlyph({ type: "retry", attempt: 1, message: "", next: 0 }, 1)).toBe(" ·")
+  })
+
+  test("uses the idle glyph when idle or unknown", () => {
+    expect(titleStatusGlyph({ type: "idle" }, 0)).toBe("*")
+    expect(titleStatusGlyph({ type: "idle" }, 1)).toBe("*")
+    expect(titleStatusGlyph(undefined)).toBe("*")
+  })
 })