From 9f368c19059389a269b540cb60967890271742f8 Mon Sep 17 00:00:00 2001
From: Julius Marminge <julius0216@outlook.com>
Date: Thu, 12 Feb 2026 20:13:36 -0800
Subject: [PATCH 1/5] Track thread terminal running state across UI and store

- add `terminalRunning` to thread state and hydration defaults
- apply terminal events in reducer to sync running/open state (close drawer on exit)
- wire drawer running-state callbacks and show a Terminal status pill in sidebar
- extend store and persistence tests for terminal running/exited behavior
---
 apps/web/src/App.tsx                   | 11 ++++
 apps/web/src/components/Sidebar.tsx    | 28 ++++++++-
 apps/web/src/persistenceSchema.test.ts |  1 +
 apps/web/src/persistenceSchema.ts      |  1 +
 apps/web/src/store.test.ts             | 79 +++++++++++++++++++++++++-
 apps/web/src/store.ts                  | 46 ++++++++++++++-
 apps/web/src/types.ts                  |  1 +
 7 files changed, 164 insertions(+), 3 deletions(-)

diff --git a/apps/web/src/App.tsx b/apps/web/src/App.tsx
index a982c1fc6e..41c7ff36fc 100644
--- a/apps/web/src/App.tsx
+++ b/apps/web/src/App.tsx
@@ -27,6 +27,16 @@ function EventRouter() {
     });
   }, [api, dispatch]);
 
+  useEffect(() => {
+    if (!api) return;
+    return api.terminal.onEvent((event) => {
+      dispatch({
+        type: "APPLY_TERMINAL_EVENT",
+        event,
+      });
+    });
+  }, [api, dispatch]);
+
   return null;
 }
 
@@ -82,6 +92,7 @@ function AutoProjectBootstrap() {
           terminalOpen: false,
           terminalHeight: DEFAULT_THREAD_TERMINAL_HEIGHT,
           terminalIds: [DEFAULT_THREAD_TERMINAL_ID],
+          runningTerminalIds: [],
           activeTerminalId: DEFAULT_THREAD_TERMINAL_ID,
           terminalGroups: [
             {
diff --git a/apps/web/src/components/Sidebar.tsx b/apps/web/src/components/Sidebar.tsx
index 32a832a491..858e438b50 100644
--- a/apps/web/src/components/Sidebar.tsx
+++ b/apps/web/src/components/Sidebar.tsx
@@ -32,7 +32,7 @@ function inferProjectName(cwd: string): string {
 }
 
 interface ThreadStatusPill {
-  label: "Working" | "Connecting" | "Completed" | "Awaiting response";
+  label: "Working" | "Connecting" | "Completed" | "Awaiting response" | "Terminal";
   colorClass: string;
   dotClass: string;
   pulse: boolean;
@@ -89,6 +89,18 @@ function threadStatusPill(thread: Thread, hasPendingApprovals: boolean): ThreadS
   return null;
 }
 
+function terminalStatusPill(thread: Thread): ThreadStatusPill | null {
+  if (thread.runningTerminalIds.length === 0) {
+    return null;
+  }
+  return {
+    label: "Terminal",
+    colorClass: "text-teal-600 dark:text-teal-300/90",
+    dotClass: "bg-teal-500 dark:bg-teal-300/90",
+    pulse: true,
+  };
+}
+
 export default function Sidebar() {
   const { state, dispatch } = useStore();
   const api = useNativeApi();
@@ -118,6 +130,7 @@ export default function Sidebar() {
           terminalOpen: false,
           terminalHeight: DEFAULT_THREAD_TERMINAL_HEIGHT,
           terminalIds: [DEFAULT_THREAD_TERMINAL_ID],
+          runningTerminalIds: [],
           activeTerminalId: DEFAULT_THREAD_TERMINAL_ID,
           terminalGroups: [
             {
@@ -388,6 +401,7 @@ export default function Sidebar() {
                       thread,
                       pendingApprovalByThreadId.get(thread.id) === true,
                     );
+                    const terminalStatus = terminalStatusPill(thread);
                     return (
                       <button
                         key={thread.id}
@@ -412,6 +426,18 @@ export default function Sidebar() {
                         }}
                       >
                         <div className="flex min-w-0 flex-1 items-center gap-1.5">
+                          {terminalStatus && (
+                            <span
+                              className={`inline-flex items-center gap-1 text-[10px] ${terminalStatus.colorClass}`}
+                            >
+                              <span
+                                className={`h-1.5 w-1.5 rounded-full ${terminalStatus.dotClass} ${
+                                  terminalStatus.pulse ? "animate-pulse" : ""
+                                }`}
+                              />
+                              <span className="hidden md:inline">{terminalStatus.label}</span>
+                            </span>
+                          )}
                           {threadStatus && (
                             <span
                               className={`inline-flex items-center gap-1 text-[10px] ${threadStatus.colorClass}`}
diff --git a/apps/web/src/persistenceSchema.test.ts b/apps/web/src/persistenceSchema.test.ts
index b05fbf352a..277d86ab26 100644
--- a/apps/web/src/persistenceSchema.test.ts
+++ b/apps/web/src/persistenceSchema.test.ts
@@ -278,6 +278,7 @@ describe("toPersistedState", () => {
       terminalOpen: true,
       terminalHeight: 320,
       terminalIds: [DEFAULT_THREAD_TERMINAL_ID, "term-2"],
+      runningTerminalIds: [],
       activeTerminalId: "term-2",
       terminalGroups: [
         { id: `group-${DEFAULT_THREAD_TERMINAL_ID}`, terminalIds: [DEFAULT_THREAD_TERMINAL_ID] },
diff --git a/apps/web/src/persistenceSchema.ts b/apps/web/src/persistenceSchema.ts
index 5738107c3c..aaf10de75c 100644
--- a/apps/web/src/persistenceSchema.ts
+++ b/apps/web/src/persistenceSchema.ts
@@ -243,6 +243,7 @@ function hydrateThread(
     terminalOpen: thread.terminalOpen ?? false,
     terminalHeight: thread.terminalHeight ?? DEFAULT_THREAD_TERMINAL_HEIGHT,
     terminalIds: safeTerminalIds,
+    runningTerminalIds: [],
     activeTerminalId,
     terminalGroups: normalizedGroups,
     activeTerminalGroupId,
diff --git a/apps/web/src/store.test.ts b/apps/web/src/store.test.ts
index 4a5dd0e099..3e157b1b25 100644
--- a/apps/web/src/store.test.ts
+++ b/apps/web/src/store.test.ts
@@ -1,4 +1,4 @@
-import type { ProviderEvent, ProviderSession } from "@t3tools/contracts";
+import type { ProviderEvent, ProviderSession, TerminalEvent } from "@t3tools/contracts";
 import { describe, expect, it } from "vitest";
 
 import { type AppState, reducer } from "./store";
@@ -38,6 +38,7 @@ function makeThread(overrides: Partial<Thread> = {}): Thread {
     terminalOpen: false,
     terminalHeight: DEFAULT_THREAD_TERMINAL_HEIGHT,
     terminalIds: [DEFAULT_THREAD_TERMINAL_ID],
+    runningTerminalIds: [],
     activeTerminalId: DEFAULT_THREAD_TERMINAL_ID,
     terminalGroups: [
       {
@@ -75,6 +76,27 @@ function makeState(thread: Thread): AppState {
   };
 }
 
+function makeTerminalStartedEvent(overrides: Partial<TerminalEvent> = {}): TerminalEvent {
+  return {
+    type: "started",
+    threadId: "thread-local-1",
+    terminalId: DEFAULT_THREAD_TERMINAL_ID,
+    createdAt: "2026-02-09T00:00:01.000Z",
+    snapshot: {
+      threadId: "thread-local-1",
+      terminalId: DEFAULT_THREAD_TERMINAL_ID,
+      cwd: "/tmp/project",
+      status: "running",
+      pid: 1234,
+      history: "",
+      exitCode: null,
+      exitSignal: null,
+      updatedAt: "2026-02-09T00:00:01.000Z",
+    },
+    ...overrides,
+  };
+}
+
 describe("store reducer thread continuity", () => {
   it("stores codexThreadId from UPDATE_SESSION", () => {
     const state = makeState(
@@ -255,6 +277,7 @@ describe("store reducer thread continuity", () => {
     const state = makeState(
       makeThread({
         terminalOpen: true,
+        runningTerminalIds: [DEFAULT_THREAD_TERMINAL_ID],
       }),
     );
     const next = reducer(state, {
@@ -265,6 +288,7 @@ describe("store reducer thread continuity", () => {
 
     expect(next.threads[0]?.terminalOpen).toBe(false);
     expect(next.threads[0]?.terminalIds).toEqual([DEFAULT_THREAD_TERMINAL_ID]);
+    expect(next.threads[0]?.runningTerminalIds).toEqual([]);
     expect(next.threads[0]?.activeTerminalId).toBe(DEFAULT_THREAD_TERMINAL_ID);
     expect(next.threads[0]?.terminalGroups).toEqual([
       {
@@ -274,6 +298,59 @@ describe("store reducer thread continuity", () => {
     ]);
   });
 
+  it("tracks running terminals from terminal lifecycle events", () => {
+    const state = makeState(makeThread());
+    const started = reducer(state, {
+      type: "APPLY_TERMINAL_EVENT",
+      event: makeTerminalStartedEvent(),
+    });
+    expect(started.threads[0]?.runningTerminalIds).toEqual([DEFAULT_THREAD_TERMINAL_ID]);
+
+    const exited = reducer(started, {
+      type: "APPLY_TERMINAL_EVENT",
+      event: {
+        type: "exited",
+        threadId: "thread-local-1",
+        terminalId: DEFAULT_THREAD_TERMINAL_ID,
+        createdAt: "2026-02-09T00:00:05.000Z",
+        exitCode: 0,
+        exitSignal: null,
+      },
+    });
+    expect(exited.threads[0]?.runningTerminalIds).toEqual([]);
+  });
+
+  it("keeps running status when another terminal in the thread is still running", () => {
+    const state = makeState(
+      makeThread({
+        terminalIds: [DEFAULT_THREAD_TERMINAL_ID, "term-2"],
+        runningTerminalIds: [DEFAULT_THREAD_TERMINAL_ID, "term-2"],
+        activeTerminalId: "term-2",
+        terminalGroups: [
+          {
+            id: `group-${DEFAULT_THREAD_TERMINAL_ID}`,
+            terminalIds: [DEFAULT_THREAD_TERMINAL_ID, "term-2"],
+          },
+        ],
+        activeTerminalGroupId: `group-${DEFAULT_THREAD_TERMINAL_ID}`,
+      }),
+    );
+
+    const next = reducer(state, {
+      type: "APPLY_TERMINAL_EVENT",
+      event: {
+        type: "exited",
+        threadId: "thread-local-1",
+        terminalId: DEFAULT_THREAD_TERMINAL_ID,
+        createdAt: "2026-02-09T00:00:07.000Z",
+        exitCode: 0,
+        exitSignal: null,
+      },
+    });
+
+    expect(next.threads[0]?.runningTerminalIds).toEqual(["term-2"]);
+  });
+
   it("backfills codexThreadId from routed provider events", () => {
     const state = makeState(makeThread({ codexThreadId: null }));
     const next = reducer(state, {
diff --git a/apps/web/src/store.ts b/apps/web/src/store.ts
index 3527d46b0f..e7937f4d3b 100644
--- a/apps/web/src/store.ts
+++ b/apps/web/src/store.ts
@@ -8,7 +8,7 @@ import {
   useReducer,
 } from "react";
 
-import type { ProviderEvent, ProviderSession } from "@t3tools/contracts";
+import type { ProviderEvent, ProviderSession, TerminalEvent } from "@t3tools/contracts";
 import { resolveModelSlug } from "./model-logic";
 import { hydratePersistedState, toPersistedState } from "./persistenceSchema";
 import { applyEventToMessages, asObject, asString, evolveSession } from "./session-logic";
@@ -43,6 +43,7 @@ type Action =
       event: ProviderEvent;
       activeAssistantItemRef: { current: string | null };
     }
+  | { type: "APPLY_TERMINAL_EVENT"; event: TerminalEvent }
   | { type: "UPDATE_SESSION"; threadId: string; session: ProviderSession }
   | {
       type: "PUSH_USER_MESSAGE";
@@ -149,6 +150,17 @@ function normalizeTerminalIds(terminalIds: string[]): string[] {
   return [DEFAULT_THREAD_TERMINAL_ID];
 }
 
+function normalizeRunningTerminalIds(
+  runningTerminalIds: string[],
+  terminalIds: string[],
+): string[] {
+  if (runningTerminalIds.length === 0) return [];
+  const validTerminalIdSet = new Set(terminalIds);
+  return [...new Set(runningTerminalIds)]
+    .map((id) => id.trim())
+    .filter((id) => id.length > 0 && validTerminalIdSet.has(id));
+}
+
 function normalizeTerminalGroupIds(terminalIds: string[]): string[] {
   return [...new Set(terminalIds.map((id) => id.trim()).filter((id) => id.length > 0))];
 }
@@ -252,6 +264,7 @@ function normalizeThreadTerminals(thread: Thread): Thread {
   return {
     ...thread,
     terminalIds,
+    runningTerminalIds: normalizeRunningTerminalIds(thread.runningTerminalIds, terminalIds),
     activeTerminalId,
     terminalGroups,
     activeTerminalGroupId,
@@ -269,6 +282,7 @@ function closeThreadTerminal(thread: Thread, terminalId: string): Thread {
       ...thread,
       terminalOpen: false,
       terminalIds: [DEFAULT_THREAD_TERMINAL_ID],
+      runningTerminalIds: [],
       activeTerminalId: DEFAULT_THREAD_TERMINAL_ID,
       terminalGroups: [
         {
@@ -309,6 +323,7 @@ function closeThreadTerminal(thread: Thread, terminalId: string): Thread {
   return normalizeThreadTerminals({
     ...thread,
     terminalIds: remainingTerminalIds,
+    runningTerminalIds: thread.runningTerminalIds.filter((id) => id !== terminalId),
     activeTerminalId: nextActiveTerminalId,
     terminalGroups: nextTerminalGroups,
   });
@@ -650,6 +665,35 @@ export function reducer(state: AppState, action: Action): AppState {
     case "TOGGLE_DIFF":
       return { ...state, diffOpen: !state.diffOpen };
 
+    case "APPLY_TERMINAL_EVENT":
+      if (!state.threads.some((thread) => thread.id === action.event.threadId)) {
+        return state;
+      }
+      return {
+        ...state,
+        threads: updateThread(state.threads, action.event.threadId, (thread) => {
+          const normalizedThread = normalizeThreadTerminals(thread);
+          const runningTerminalIdSet = new Set(normalizedThread.runningTerminalIds);
+          if (
+            action.event.type === "started" ||
+            action.event.type === "restarted"
+          ) {
+            if (action.event.snapshot.status === "running") {
+              runningTerminalIdSet.add(action.event.terminalId);
+            } else {
+              runningTerminalIdSet.delete(action.event.terminalId);
+            }
+          } else if (action.event.type === "exited" || action.event.type === "error") {
+            runningTerminalIdSet.delete(action.event.terminalId);
+          }
+
+          return normalizeThreadTerminals({
+            ...normalizedThread,
+            runningTerminalIds: [...runningTerminalIdSet],
+          });
+        }),
+      };
+
     case "APPLY_EVENT": {
       const { event, activeAssistantItemRef } = action;
       const target = findThreadBySessionId(state.threads, event.sessionId);
diff --git a/apps/web/src/types.ts b/apps/web/src/types.ts
index 56343f128e..d662997231 100644
--- a/apps/web/src/types.ts
+++ b/apps/web/src/types.ts
@@ -48,6 +48,7 @@ export interface Thread {
   terminalOpen: boolean;
   terminalHeight: number;
   terminalIds: string[];
+  runningTerminalIds: string[];
   activeTerminalId: string;
   terminalGroups: ThreadTerminalGroup[];
   activeTerminalGroupId: string;

From 4c0ea814c7c10ca6ad647a8fb0481942d64a2f7b Mon Sep 17 00:00:00 2001
From: Julius Marminge <julius0216@outlook.com>
Date: Thu, 12 Feb 2026 21:14:31 -0800
Subject: [PATCH 2/5] Migrate legacy terminal history to terminal-scoped log
 path

- On open, read legacy transcript files and write them to the new terminal-scoped history path
- Remove legacy files after migration and warn if cleanup fails
- Update tests to assert migration, content preservation, and legacy file removal
---
 apps/server/src/terminalManager.test.ts |  7 +++++--
 apps/server/src/terminalManager.ts      | 22 ++++++++++++++++------
 2 files changed, 21 insertions(+), 8 deletions(-)

diff --git a/apps/server/src/terminalManager.test.ts b/apps/server/src/terminalManager.test.ts
index b8257e07c6..9b77d582bc 100644
--- a/apps/server/src/terminalManager.test.ts
+++ b/apps/server/src/terminalManager.test.ts
@@ -334,15 +334,18 @@ describe("TerminalManager", () => {
     manager.dispose();
   });
 
-  it("loads existing legacy transcript filenames and keeps new naming for writes", async () => {
+  it("migrates legacy transcript filenames to terminal-scoped history path on open", async () => {
     const { manager, logsDir } = makeManager();
     const legacyPath = path.join(logsDir, "thread-1.log");
+    const nextPath = historyLogPath(logsDir);
     fs.writeFileSync(legacyPath, "legacy-line\n", "utf8");
 
     const snapshot = await manager.open(openInput());
 
     expect(snapshot.history).toBe("legacy-line\n");
-    expect(fs.existsSync(legacyPath)).toBe(true);
+    expect(fs.existsSync(nextPath)).toBe(true);
+    expect(fs.readFileSync(nextPath, "utf8")).toBe("legacy-line\n");
+    expect(fs.existsSync(legacyPath)).toBe(false);
 
     manager.dispose();
   });
diff --git a/apps/server/src/terminalManager.ts b/apps/server/src/terminalManager.ts
index 8c8d18cdf5..8fe6d662e7 100644
--- a/apps/server/src/terminalManager.ts
+++ b/apps/server/src/terminalManager.ts
@@ -582,12 +582,12 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
   }
 
   private async readHistory(threadId: string, terminalId: string): Promise<string> {
-    const historyPath = this.historyPath(threadId, terminalId);
+    const nextPath = this.historyPath(threadId, terminalId);
     try {
-      const raw = await fs.promises.readFile(historyPath, "utf8");
+      const raw = await fs.promises.readFile(nextPath, "utf8");
       const capped = capHistory(raw, this.historyLineLimit);
       if (capped !== raw) {
-        await fs.promises.writeFile(historyPath, capped, "utf8");
+        await fs.promises.writeFile(nextPath, capped, "utf8");
       }
       return capped;
     } catch (error) {
@@ -600,12 +600,22 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
       return "";
     }
 
+    const legacyPath = this.legacyHistoryPath(threadId);
     try {
-      const raw = await fs.promises.readFile(this.legacyHistoryPath(threadId), "utf8");
+      const raw = await fs.promises.readFile(legacyPath, "utf8");
       const capped = capHistory(raw, this.historyLineLimit);
-      if (capped !== raw) {
-        await fs.promises.writeFile(this.legacyHistoryPath(threadId), capped, "utf8");
+
+      // Migrate legacy transcript filename to the terminal-scoped path.
+      await fs.promises.writeFile(nextPath, capped, "utf8");
+      try {
+        await fs.promises.rm(legacyPath, { force: true });
+      } catch (cleanupError) {
+        this.logger.warn("failed to remove legacy terminal history", {
+          threadId,
+          error: cleanupError instanceof Error ? cleanupError.message : String(cleanupError),
+        });
       }
+
       return capped;
     } catch (error) {
       if ((error as NodeJS.ErrnoException).code === "ENOENT") {

From a58d35b0a19c469979819f435c2f091ae093033c Mon Sep 17 00:00:00 2001
From: Julius Marminge <julius0216@outlook.com>
Date: Thu, 12 Feb 2026 21:17:11 -0800
Subject: [PATCH 3/5] Close terminal session when hiding terminal panel

- Attempt `api.terminal.close` when toggling an open terminal off
- Fall back to sending `exit` if close is unavailable or fails
- Include `api` in callback dependencies to keep behavior current
---
 apps/web/src/components/ChatView.tsx | 29 +++++++++++++++-------------
 1 file changed, 16 insertions(+), 13 deletions(-)

diff --git a/apps/web/src/components/ChatView.tsx b/apps/web/src/components/ChatView.tsx
index 966d3eb4c2..5423ac60a6 100644
--- a/apps/web/src/components/ChatView.tsx
+++ b/apps/web/src/components/ChatView.tsx
@@ -263,12 +263,23 @@ export default function ChatView() {
   const toggleTerminalVisibility = useCallback(() => {
     if (!activeThreadId) return;
     const isOpen = Boolean(activeThread?.terminalOpen);
+
+    if (isOpen && api) {
+      if (typeof api.terminal.close === "function") {
+        void api.terminal.close({ threadId: activeThreadId }).catch(() => {
+          void api.terminal.write({ threadId: activeThreadId, data: "exit\n" }).catch(() => undefined);
+        });
+      } else {
+        void api.terminal.write({ threadId: activeThreadId, data: "exit\n" }).catch(() => undefined);
+      }
+    }
+
     dispatch({
       type: "SET_THREAD_TERMINAL_OPEN",
       threadId: activeThreadId,
       open: !isOpen,
     });
-  }, [activeThread?.terminalOpen, activeThreadId, dispatch]);
+  }, [activeThread?.terminalOpen, activeThreadId, api, dispatch]);
   const splitTerminal = useCallback(() => {
     if (!activeThreadId) return;
     dispatch({
@@ -303,21 +314,13 @@ export default function ChatView() {
     (terminalId: string) => {
       if (!activeThreadId || !api) return;
       const fallbackExitWrite = () =>
-        api.terminal
-          .write({ threadId: activeThreadId, terminalId, data: "exit\n" })
-          .catch(() => undefined);
-      const fallbackClearAndExit = () =>
-        api.terminal
-          .clear({ threadId: activeThreadId, terminalId })
-          .catch(() => undefined)
-          .then(() => fallbackExitWrite())
-          .catch(() => undefined);
+        api.terminal.write({ threadId: activeThreadId, terminalId, data: "exit\n" }).catch(() => undefined);
       if ("close" in api.terminal && typeof api.terminal.close === "function") {
         void api.terminal
-          .close({ threadId: activeThreadId, terminalId, deleteHistory: true })
-          .catch(() => fallbackClearAndExit());
+          .close({ threadId: activeThreadId, terminalId })
+          .catch(() => fallbackExitWrite());
       } else {
-        void fallbackClearAndExit();
+        void fallbackExitWrite();
       }
       dispatch({
         type: "CLOSE_THREAD_TERMINAL",

From b5293287c39f5bada163a40045e363e46aa30e6b Mon Sep 17 00:00:00 2001
From: Julius Marminge <julius0216@outlook.com>
Date: Thu, 12 Feb 2026 22:01:52 -0800
Subject: [PATCH 4/5] Emit terminal activity events from subprocess polling

- Add cross-platform subprocess polling in `TerminalManager` and emit `activity` events when child-process state changes
- Update web store to derive `runningTerminalIds` from `activity.hasRunningSubprocess` instead of start/restart events
- Extend terminal contracts and tests to include the new `activity` event type

Co-authored-by: codex <codex@users.noreply.github.com>
---
 apps/server/src/terminalManager.test.ts |  44 +++++-
 apps/server/src/terminalManager.ts      | 189 +++++++++++++++++++++++-
 apps/web/src/store.test.ts              |  29 +++-
 apps/web/src/store.ts                   |   4 +-
 packages/contracts/src/terminal.test.ts |  11 ++
 packages/contracts/src/terminal.ts      |   6 +
 6 files changed, 276 insertions(+), 7 deletions(-)

diff --git a/apps/server/src/terminalManager.test.ts b/apps/server/src/terminalManager.test.ts
index 9b77d582bc..59e8cae453 100644
--- a/apps/server/src/terminalManager.test.ts
+++ b/apps/server/src/terminalManager.test.ts
@@ -137,7 +137,11 @@ describe("TerminalManager", () => {
 
   function makeManager(
     historyLineLimit = 5,
-    options: { shellResolver?: () => string } = {},
+    options: {
+      shellResolver?: () => string;
+      subprocessChecker?: (terminalPid: number) => Promise<boolean>;
+      subprocessPollIntervalMs?: number;
+    } = {},
   ) {
     const logsDir = fs.mkdtempSync(path.join(os.tmpdir(), "t3code-terminal-"));
     tempDirs.push(logsDir);
@@ -147,6 +151,8 @@ describe("TerminalManager", () => {
       ptyAdapter,
       historyLineLimit,
       shellResolver: options.shellResolver ?? (() => "/bin/bash"),
+      subprocessChecker: options.subprocessChecker,
+      subprocessPollIntervalMs: options.subprocessPollIntervalMs,
     });
     return { logsDir, ptyAdapter, manager };
   }
@@ -273,6 +279,42 @@ describe("TerminalManager", () => {
     manager.dispose();
   });
 
+  it("emits subprocess activity events when child-process state changes", async () => {
+    let hasRunningSubprocess = false;
+    const { manager } = makeManager(5, {
+      subprocessChecker: async () => hasRunningSubprocess,
+      subprocessPollIntervalMs: 20,
+    });
+    const events: TerminalEvent[] = [];
+    manager.on("event", (event) => {
+      events.push(event);
+    });
+
+    await manager.open(openInput());
+    await waitFor(() => events.some((event) => event.type === "started"));
+    expect(events.some((event) => event.type === "activity")).toBe(false);
+
+    hasRunningSubprocess = true;
+    await waitFor(
+      () =>
+        events.some(
+          (event) => event.type === "activity" && event.hasRunningSubprocess === true,
+        ),
+      1_200,
+    );
+
+    hasRunningSubprocess = false;
+    await waitFor(
+      () =>
+        events.some(
+          (event) => event.type === "activity" && event.hasRunningSubprocess === false,
+        ),
+      1_200,
+    );
+
+    manager.dispose();
+  });
+
   it("caps persisted history to configured line limit", async () => {
     const { manager, ptyAdapter } = makeManager(3);
     await manager.open(openInput());
diff --git a/apps/server/src/terminalManager.ts b/apps/server/src/terminalManager.ts
index 8fe6d662e7..eb881f3cd0 100644
--- a/apps/server/src/terminalManager.ts
+++ b/apps/server/src/terminalManager.ts
@@ -21,9 +21,13 @@ import {
 
 import { createLogger } from "./logger";
 import { NodePtyAdapter, type PtyAdapter, type PtyExitEvent, type PtyProcess } from "./ptyAdapter";
+import { runProcess } from "./processRunner";
 
 const DEFAULT_HISTORY_LINE_LIMIT = 5_000;
 const DEFAULT_PERSIST_DEBOUNCE_MS = 40;
+const DEFAULT_SUBPROCESS_POLL_INTERVAL_MS = 1_000;
+
+type TerminalSubprocessChecker = (terminalPid: number) => Promise<boolean>;
 
 export interface TerminalManagerEvents {
   event: [event: TerminalEvent];
@@ -34,6 +38,8 @@ export interface TerminalManagerOptions {
   historyLineLimit?: number;
   ptyAdapter?: PtyAdapter;
   shellResolver?: () => string;
+  subprocessChecker?: TerminalSubprocessChecker;
+  subprocessPollIntervalMs?: number;
 }
 
 interface TerminalSessionState {
@@ -51,6 +57,7 @@ interface TerminalSessionState {
   process: PtyProcess | null;
   unsubscribeData: (() => void) | null;
   unsubscribeExit: (() => void) | null;
+  hasRunningSubprocess: boolean;
 }
 
 function defaultShellResolver(): string {
@@ -122,6 +129,83 @@ function isRetryableShellSpawnError(error: unknown): boolean {
   );
 }
 
+async function checkWindowsSubprocessActivity(terminalPid: number): Promise<boolean> {
+  const command = [
+    `$children = Get-CimInstance Win32_Process -Filter "ParentProcessId = ${terminalPid}" -ErrorAction SilentlyContinue`,
+    "if ($children) { exit 0 }",
+    "exit 1",
+  ].join("; ");
+  try {
+    const result = await runProcess(
+      "powershell.exe",
+      ["-NoProfile", "-NonInteractive", "-Command", command],
+      {
+        timeoutMs: 1_500,
+        allowNonZeroExit: true,
+        maxBufferBytes: 32_768,
+        outputMode: "truncate",
+      },
+    );
+    return result.code === 0;
+  } catch {
+    return false;
+  }
+}
+
+async function checkPosixSubprocessActivity(terminalPid: number): Promise<boolean> {
+  try {
+    const pgrepResult = await runProcess("pgrep", ["-P", String(terminalPid)], {
+      timeoutMs: 1_000,
+      allowNonZeroExit: true,
+      maxBufferBytes: 32_768,
+      outputMode: "truncate",
+    });
+    if (pgrepResult.code === 0) {
+      return pgrepResult.stdout.trim().length > 0;
+    }
+    if (pgrepResult.code === 1) {
+      return false;
+    }
+  } catch {
+    // Fall back to ps when pgrep is unavailable.
+  }
+
+  try {
+    const psResult = await runProcess("ps", ["-eo", "pid=,ppid="], {
+      timeoutMs: 1_000,
+      allowNonZeroExit: true,
+      maxBufferBytes: 262_144,
+      outputMode: "truncate",
+    });
+    if (psResult.code !== 0) {
+      return false;
+    }
+
+    for (const line of psResult.stdout.split(/\r?\n/g)) {
+      const [pidRaw, ppidRaw] = line.trim().split(/\s+/g);
+      const pid = Number(pidRaw);
+      const ppid = Number(ppidRaw);
+      if (!Number.isInteger(pid) || !Number.isInteger(ppid)) continue;
+      if (ppid === terminalPid) {
+        return true;
+      }
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+
+async function defaultSubprocessChecker(terminalPid: number): Promise<boolean> {
+  if (!Number.isInteger(terminalPid) || terminalPid <= 0) {
+    return false;
+  }
+  if (process.platform === "win32") {
+    return checkWindowsSubprocessActivity(terminalPid);
+  }
+  return checkPosixSubprocessActivity(terminalPid);
+}
+
 function capHistory(history: string, maxLines: number): string {
   if (history.length === 0) return history;
   const hasTrailingNewline = history.endsWith("\n");
@@ -161,6 +245,10 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
   private readonly pendingPersistHistory = new Map<string, string>();
   private readonly threadLocks = new Map<string, Promise<void>>();
   private readonly persistDebounceMs: number;
+  private readonly subprocessChecker: TerminalSubprocessChecker;
+  private readonly subprocessPollIntervalMs: number;
+  private subprocessPollTimer: ReturnType<typeof setInterval> | null = null;
+  private subprocessPollInFlight = false;
   private readonly logger = createLogger("terminal");
 
   constructor(options: TerminalManagerOptions = {}) {
@@ -170,6 +258,9 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
     this.ptyAdapter = options.ptyAdapter ?? new NodePtyAdapter();
     this.shellResolver = options.shellResolver ?? defaultShellResolver;
     this.persistDebounceMs = DEFAULT_PERSIST_DEBOUNCE_MS;
+    this.subprocessChecker = options.subprocessChecker ?? defaultSubprocessChecker;
+    this.subprocessPollIntervalMs =
+      options.subprocessPollIntervalMs ?? DEFAULT_SUBPROCESS_POLL_INTERVAL_MS;
     fs.mkdirSync(this.logsDir, { recursive: true });
   }
 
@@ -198,6 +289,7 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
           process: null,
           unsubscribeData: null,
           unsubscribeExit: null,
+          hasRunningSubprocess: false,
         };
         this.sessions.set(sessionKey, session);
         this.startSession(session, input, "started");
@@ -294,6 +386,7 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
           process: null,
           unsubscribeData: null,
           unsubscribeExit: null,
+          hasRunningSubprocess: false,
         };
         this.sessions.set(sessionKey, session);
       } else {
@@ -334,14 +427,17 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
       if (input.deleteHistory) {
         await this.deleteAllHistoryForThread(input.threadId);
       }
+      this.updateSubprocessPollingState();
     });
   }
 
   dispose(): void {
-    for (const session of this.sessions.values()) {
+    this.stopSubprocessPolling();
+    const sessions = [...this.sessions.values()];
+    this.sessions.clear();
+    for (const session of sessions) {
       this.stopProcess(session);
     }
-    this.sessions.clear();
     for (const timer of this.persistTimers.values()) {
       clearTimeout(timer);
     }
@@ -364,6 +460,7 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
     session.rows = input.rows;
     session.exitCode = null;
     session.exitSignal = null;
+    session.hasRunningSubprocess = false;
     session.updatedAt = new Date().toISOString();
 
     let ptyProcess: PtyProcess | null = null;
@@ -413,6 +510,7 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
       session.unsubscribeExit = ptyProcess.onExit((event) => {
         this.onProcessExit(session, event);
       });
+      this.updateSubprocessPollingState();
       this.emitEvent({
         type: eventType,
         threadId: session.threadId,
@@ -431,7 +529,9 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
       session.status = "error";
       session.pid = null;
       session.process = null;
+      session.hasRunningSubprocess = false;
       session.updatedAt = new Date().toISOString();
+      this.updateSubprocessPollingState();
       const message = error instanceof Error ? error.message : "Terminal start failed";
       this.emitEvent({
         type: "error",
@@ -466,6 +566,7 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
     this.cleanupProcessHandles(session);
     session.process = null;
     session.pid = null;
+    session.hasRunningSubprocess = false;
     session.status = "exited";
     session.exitCode = Number.isInteger(event.exitCode) ? event.exitCode : null;
     session.exitSignal = Number.isInteger(event.signal) ? event.signal : null;
@@ -478,6 +579,7 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
       exitCode: session.exitCode,
       exitSignal: session.exitSignal,
     });
+    this.updateSubprocessPollingState();
   }
 
   private stopProcess(session: TerminalSessionState): void {
@@ -486,6 +588,7 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
     this.cleanupProcessHandles(session);
     session.process = null;
     session.pid = null;
+    session.hasRunningSubprocess = false;
     session.status = "exited";
     session.updatedAt = new Date().toISOString();
     try {
@@ -498,6 +601,7 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
         error: message,
       });
     }
+    this.updateSubprocessPollingState();
   }
 
   private cleanupProcessHandles(session: TerminalSessionState): void {
@@ -660,6 +764,86 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
     }
   }
 
+  private updateSubprocessPollingState(): void {
+    const hasRunningSessions = [...this.sessions.values()].some(
+      (session) => session.status === "running" && session.pid !== null,
+    );
+    if (hasRunningSessions) {
+      this.ensureSubprocessPolling();
+      return;
+    }
+    this.stopSubprocessPolling();
+  }
+
+  private ensureSubprocessPolling(): void {
+    if (this.subprocessPollTimer) return;
+    this.subprocessPollTimer = setInterval(() => {
+      void this.pollSubprocessActivity();
+    }, this.subprocessPollIntervalMs);
+    this.subprocessPollTimer.unref?.();
+    void this.pollSubprocessActivity();
+  }
+
+  private stopSubprocessPolling(): void {
+    if (!this.subprocessPollTimer) return;
+    clearInterval(this.subprocessPollTimer);
+    this.subprocessPollTimer = null;
+  }
+
+  private async pollSubprocessActivity(): Promise<void> {
+    if (this.subprocessPollInFlight) return;
+
+    const runningSessions = [...this.sessions.values()].filter(
+      (session): session is TerminalSessionState & { pid: number } =>
+        session.status === "running" && Number.isInteger(session.pid),
+    );
+    if (runningSessions.length === 0) {
+      this.stopSubprocessPolling();
+      return;
+    }
+
+    this.subprocessPollInFlight = true;
+    try {
+      await Promise.all(
+        runningSessions.map(async (session) => {
+          const terminalPid = session.pid;
+          let hasRunningSubprocess = false;
+          try {
+            hasRunningSubprocess = await this.subprocessChecker(terminalPid);
+          } catch (error) {
+            this.logger.warn("failed to check terminal subprocess activity", {
+              threadId: session.threadId,
+              terminalId: session.terminalId,
+              terminalPid,
+              error: error instanceof Error ? error.message : String(error),
+            });
+            return;
+          }
+
+          const liveSession = this.sessions.get(toSessionKey(session.threadId, session.terminalId));
+          if (!liveSession || liveSession.status !== "running" || liveSession.pid !== terminalPid) {
+            return;
+          }
+          if (liveSession.hasRunningSubprocess === hasRunningSubprocess) {
+            return;
+          }
+
+          liveSession.hasRunningSubprocess = hasRunningSubprocess;
+          liveSession.updatedAt = new Date().toISOString();
+          this.emitEvent({
+            type: "activity",
+            threadId: liveSession.threadId,
+            terminalId: liveSession.terminalId,
+            createdAt: new Date().toISOString(),
+            hasRunningSubprocess,
+          });
+        }),
+      );
+    } finally {
+      this.subprocessPollInFlight = false;
+    }
+  }
+
   private async assertValidCwd(cwd: string): Promise<void> {
     let stats: fs.Stats;
     try {
@@ -686,6 +870,7 @@ export class TerminalManager extends EventEmitter<TerminalManagerEvents> {
       this.stopProcess(session);
       this.sessions.delete(key);
     }
+    this.updateSubprocessPollingState();
     await this.flushPersistQueue(threadId, terminalId);
     if (deleteHistory) {
       await this.deleteHistory(threadId, terminalId);
diff --git a/apps/web/src/store.test.ts b/apps/web/src/store.test.ts
index 3e157b1b25..3294cef503 100644
--- a/apps/web/src/store.test.ts
+++ b/apps/web/src/store.test.ts
@@ -97,6 +97,17 @@ function makeTerminalStartedEvent(overrides: Partial<TerminalEvent> = {}): Termi
   };
 }
 
+function makeTerminalActivityEvent(overrides: Partial<TerminalEvent> = {}): TerminalEvent {
+  return {
+    type: "activity",
+    threadId: "thread-local-1",
+    terminalId: DEFAULT_THREAD_TERMINAL_ID,
+    createdAt: "2026-02-09T00:00:02.000Z",
+    hasRunningSubprocess: true,
+    ...overrides,
+  };
+}
+
 describe("store reducer thread continuity", () => {
   it("stores codexThreadId from UPDATE_SESSION", () => {
     const state = makeState(
@@ -298,15 +309,27 @@ describe("store reducer thread continuity", () => {
     ]);
   });
 
-  it("tracks running terminals from terminal lifecycle events", () => {
+  it("tracks running terminals from subprocess activity events", () => {
     const state = makeState(makeThread());
     const started = reducer(state, {
       type: "APPLY_TERMINAL_EVENT",
       event: makeTerminalStartedEvent(),
     });
-    expect(started.threads[0]?.runningTerminalIds).toEqual([DEFAULT_THREAD_TERMINAL_ID]);
+    expect(started.threads[0]?.runningTerminalIds).toEqual([]);
+
+    const active = reducer(started, {
+      type: "APPLY_TERMINAL_EVENT",
+      event: makeTerminalActivityEvent(),
+    });
+    expect(active.threads[0]?.runningTerminalIds).toEqual([DEFAULT_THREAD_TERMINAL_ID]);
+
+    const idle = reducer(active, {
+      type: "APPLY_TERMINAL_EVENT",
+      event: makeTerminalActivityEvent({ hasRunningSubprocess: false }),
+    });
+    expect(idle.threads[0]?.runningTerminalIds).toEqual([]);
 
-    const exited = reducer(started, {
+    const exited = reducer(active, {
       type: "APPLY_TERMINAL_EVENT",
       event: {
         type: "exited",
diff --git a/apps/web/src/store.ts b/apps/web/src/store.ts
index e7937f4d3b..79cbfa7077 100644
--- a/apps/web/src/store.ts
+++ b/apps/web/src/store.ts
@@ -678,7 +678,9 @@ export function reducer(state: AppState, action: Action): AppState {
             action.event.type === "started" ||
             action.event.type === "restarted"
           ) {
-            if (action.event.snapshot.status === "running") {
+            runningTerminalIdSet.delete(action.event.terminalId);
+          } else if (action.event.type === "activity") {
+            if (action.event.hasRunningSubprocess) {
               runningTerminalIdSet.add(action.event.terminalId);
             } else {
               runningTerminalIdSet.delete(action.event.terminalId);
diff --git a/packages/contracts/src/terminal.test.ts b/packages/contracts/src/terminal.test.ts
index 336a047626..8704ee1a53 100644
--- a/packages/contracts/src/terminal.test.ts
+++ b/packages/contracts/src/terminal.test.ts
@@ -139,4 +139,15 @@ describe("terminalEventSchema", () => {
     });
     expect(result.success).toBe(true);
   });
+
+  it("accepts activity events", () => {
+    const result = terminalEventSchema.safeParse({
+      type: "activity",
+      threadId: "thread-1",
+      terminalId: DEFAULT_TERMINAL_ID,
+      createdAt: new Date().toISOString(),
+      hasRunningSubprocess: true,
+    });
+    expect(result.success).toBe(true);
+  });
 });
diff --git a/packages/contracts/src/terminal.ts b/packages/contracts/src/terminal.ts
index cec35f5956..57d2d9f63c 100644
--- a/packages/contracts/src/terminal.ts
+++ b/packages/contracts/src/terminal.ts
@@ -91,6 +91,11 @@ export const terminalRestartedEventSchema = terminalEventBaseSchema.extend({
   snapshot: terminalSessionSnapshotSchema,
 });
 
+export const terminalActivityEventSchema = terminalEventBaseSchema.extend({
+  type: z.literal("activity"),
+  hasRunningSubprocess: z.boolean(),
+});
+
 export const terminalEventSchema = z.discriminatedUnion("type", [
   terminalStartedEventSchema,
   terminalOutputEventSchema,
@@ -98,6 +103,7 @@ export const terminalEventSchema = z.discriminatedUnion("type", [
   terminalErrorEventSchema,
   terminalClearedEventSchema,
   terminalRestartedEventSchema,
+  terminalActivityEventSchema,
 ]);
 
 export type TerminalThreadInput = z.input<typeof terminalThreadInputSchema>;

From b185c1403341e349d47dddb16efaccbbef4bf35b Mon Sep 17 00:00:00 2001
From: Julius Marminge <julius0216@outlook.com>
Date: Thu, 12 Feb 2026 22:14:08 -0800
Subject: [PATCH 5/5] Tighten test fixtures for terminal options and event
 typing

- Pass subprocess test options only when defined in `terminalManager` tests
- Narrow web store terminal event fixtures to `started`/`activity` event shapes
---
 apps/server/src/terminalManager.test.ts |  6 ++++--
 apps/web/src/store.test.ts              | 11 +++++++++--
 2 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/apps/server/src/terminalManager.test.ts b/apps/server/src/terminalManager.test.ts
index 59e8cae453..bf7da6199f 100644
--- a/apps/server/src/terminalManager.test.ts
+++ b/apps/server/src/terminalManager.test.ts
@@ -151,8 +151,10 @@ describe("TerminalManager", () => {
       ptyAdapter,
       historyLineLimit,
       shellResolver: options.shellResolver ?? (() => "/bin/bash"),
-      subprocessChecker: options.subprocessChecker,
-      subprocessPollIntervalMs: options.subprocessPollIntervalMs,
+      ...(options.subprocessChecker ? { subprocessChecker: options.subprocessChecker } : {}),
+      ...(options.subprocessPollIntervalMs
+        ? { subprocessPollIntervalMs: options.subprocessPollIntervalMs }
+        : {}),
     });
     return { logsDir, ptyAdapter, manager };
   }
diff --git a/apps/web/src/store.test.ts b/apps/web/src/store.test.ts
index 3294cef503..7497e46bad 100644
--- a/apps/web/src/store.test.ts
+++ b/apps/web/src/store.test.ts
@@ -5,6 +5,9 @@ import { type AppState, reducer } from "./store";
 import { DEFAULT_THREAD_TERMINAL_HEIGHT, DEFAULT_THREAD_TERMINAL_ID } from "./types";
 import type { Thread } from "./types";
 
+type TerminalStartedEvent = Extract<TerminalEvent, { type: "started" }>;
+type TerminalActivityEvent = Extract<TerminalEvent, { type: "activity" }>;
+
 function makeSession(overrides: Partial<ProviderSession> = {}): ProviderSession {
   return {
     sessionId: "sess-1",
@@ -76,7 +79,9 @@ function makeState(thread: Thread): AppState {
   };
 }
 
-function makeTerminalStartedEvent(overrides: Partial<TerminalEvent> = {}): TerminalEvent {
+function makeTerminalStartedEvent(
+  overrides: Partial<TerminalStartedEvent> = {},
+): TerminalStartedEvent {
   return {
     type: "started",
     threadId: "thread-local-1",
@@ -97,7 +102,9 @@ function makeTerminalStartedEvent(overrides: Partial<TerminalEvent> = {}): Termi
   };
 }
 
-function makeTerminalActivityEvent(overrides: Partial<TerminalEvent> = {}): TerminalEvent {
+function makeTerminalActivityEvent(
+  overrides: Partial<TerminalActivityEvent> = {},
+): TerminalActivityEvent {
   return {
     type: "activity",
     threadId: "thread-local-1",