@brimveyn/aimux 1.19.6 → 1.20.1

package/src/index.tsx

@@ -1,9 +1,4 @@
 #!/usr/bin/env bun
-import { createCliRenderer } from '@opentui/core'
-import { createRoot } from '@opentui/react'
-
-import { App } from './app'
-import { loadUserConfig } from './config/loader'
 import { runDaemon } from './daemon/daemon'
 import { getRuntimeProfile } from './daemon/runtime-paths'
 import { logDebug } from './debug/input-log'
@@ -12,8 +7,6 @@ import { runRestartDaemon } from './restart-daemon'
 import { runRestartTerminalManager } from './restart-terminal-manager'
 import { createSessionBackend } from './session-backend/bootstrap'
 import { runTerminalManager } from './terminal-manager/terminal-manager'
-import { BreakingUpdateScreen } from './ui/breaking-update-screen'
-import { setHostPalette } from './ui/host-palette'
 import { runUpdate } from './update'
 
 const command = process.argv[2]
@@ -22,7 +15,7 @@ const runtimeProfile = getRuntimeProfile()
 // CLI control plane (docs/reference/cli.md). Branch BEFORE the UI bootstrap so
 // `aimux tab list` from a non-TTY shell never spins up the React renderer.
 // Dynamic import keeps the CLI code out of the UI's cold-start cost.
-const CLI_GROUPS = new Set(['tab', 'workspace', 'worktree'])
+const CLI_GROUPS = new Set(['tab', 'workspace', 'worktree', 'worker'])
 if (typeof command === 'string' && CLI_GROUPS.has(command)) {
   const { runCli } = await import('./cli')
   process.exit(await runCli(process.argv.slice(2)))
@@ -61,81 +54,27 @@ if (command === 'terminal-manager') {
 }
 
 if (command === '--help' || command === '-h' || command === 'help') {
-  process.stdout.write(
-    [
-      'aimux — terminal multiplexer for AI CLIs',
-      '',
-      'Two surfaces:',
-      '  • Interactive TUI (no args): drive assistants side-by-side in one window.',
-      '  • CLI control plane (`aimux <group> <verb>`): script-friendly, JSON output,',
-      '    designed to be driven by another agent or a shell pipeline.',
-      '',
-      'Interactive',
-      '  aimux                             Start the TUI in the current profile',
-      '',
-      'CLI control plane (JSON on stdout, human-readable errors on stderr)',
-      '  aimux tab       list | create | send | focus | close | snapshot | tail | wait',
-      '  aimux workspace list | show | create | switch | close',
-      '  aimux worktree  list | create | remove',
-      '',
-      '  aimux <group> --help              List verbs in that group',
-      '  aimux <group> <verb> --help       Show flags, args, and exit codes',
-      '',
-      'Common CLI verbs at a glance',
-      '  aimux tab list                                     Enumerate tabs (+ activeTabId)',
-      '  aimux tab create --assistant <id> [--title …]      Spawn claude / codex / opencode / grok / kimi / terminal / …',
-      '  aimux tab send <tabId> [text] [--enter|--keys|--stdin]  Type, chord, or paste into a tab',
-      '  aimux tab focus <tabId>                            Bring a tab to the foreground',
-      '  aimux tab close <tabId>                            Terminate a tab',
-      '  aimux tab snapshot <tabId> [--tail N] [--format …] Capture the screen (json | text)',
-      '  aimux tab tail <tabId> [--follow-status] […]       NDJSON stream of renders / status',
-      '  aimux tab wait <tabId> --status <idle|working|waiting-input>  Block on an activity state',
-      '  aimux workspace show                               Dump the active workspace + worktrees',
-      '  aimux workspace create <name> [--project P] [--switch [--wait]]',
-      '  aimux workspace switch <ws> [--wait --timeout N]   Move the running UI to another workspace',
-      '  aimux worktree create --name <n> [--branch B --base R]',
-      '  aimux worktree remove <id|path> [--force]',
-      '',
-      'Shared flags (accepted by every CLI verb)',
-      '  --workspace <id|name>             Target a specific workspace (default: active)',
-      '  --profile <name>                  Runtime profile (also settable via AIMUX_PROFILE)',
-      '  --json                            Reserved; JSON is always on',
-      '',
-      'Maintenance',
-      '  aimux update                      Update aimux to the latest published version',
-      '  aimux doctor                      Diagnose setup (paths, sockets, PTY, integrations)',
-      '  aimux restart-daemon              Restart the IPC daemon (keeps live workspaces)',
-      '  aimux restart-terminal-manager    Restart terminal-manager (kills live workspaces)',
-      '  aimux --version                   Print the installed version',
-      '',
-      'Exit codes',
-      '  0    success',
-      '  2    usage error (bad flags, unknown command, missing argument)',
-      '  3    runtime error (server replied with error, command failed)',
-      '  4    daemon unreachable (socket missing and autostart failed)',
-      '  124  timeout (tab wait, tab tail --timeout, workspace switch --wait)',
-      '',
-      'Env',
-      '  AIMUX_PROFILE                     Runtime profile (state dir, socket paths)',
-      '',
-      'Recipes for agents',
-      '  # spawn Claude, wait for idle, dump the last 40 non-blank lines',
-      '  TAB=$(aimux tab create --assistant claude --title fixup | jq -r .tabId)',
-      '  aimux tab send "$TAB" "explain this repo" --enter',
-      '  aimux tab wait "$TAB" --status idle --timeout 60000',
-      '  aimux tab snapshot "$TAB" --tail 40 --format text',
-      '',
-      '  # send a control chord (Ctrl-C then Esc) using vim-style notation',
-      '  aimux tab send "$TAB" "<C-c><Esc>" --keys',
-      '',
-      '  # follow a tab as NDJSON, one render (or tabStatus) per line',
-      '  aimux tab tail "$TAB" --rate-limit-ms 100 --follow-status',
-      '',
-    ].join('\n')
-  )
-  process.exit(0)
+  const { runCli } = await import('./cli')
+  process.exit(await runCli([]))
 }
 
+const [
+  { createCliRenderer },
+  { createRoot },
+  { App },
+  { loadUserConfig },
+  { BreakingUpdateScreen },
+  { setHostPalette },
+] = await Promise.all([
+  import('@opentui/core'),
+  import('@opentui/react'),
+  import('./app'),
+  import('./config/loader'),
+  import('./ui/breaking-update-screen'),
+  import('./ui/host-palette'),
+])
+const resolvedConfig = await loadUserConfig()
+
 const renderer = await createCliRenderer({
   autoFocus: true,
   // Transparent clear color so cells untouched by BoxRenderable paints (e.g.
@@ -164,7 +103,6 @@ try {
 
 const root = createRoot(renderer)
 
-const resolvedConfig = await loadUserConfig()
 logDebug('index.userConfigLoaded', {
   leader: resolvedConfig.keymaps.leader,
   modeCount: resolvedConfig.keymaps.modes.size,
@@ -179,6 +117,7 @@ if (resolvedConfig.theme?.beta?.experimentalSyntaxHighlight === true) {
 }
 
 const backend = await createSessionBackend({
+  autoRenameConfig: resolvedConfig.autoRename,
   onBreakingUpdateRequired: () =>
     new Promise<void>((resolve) => {
       root.render(<BreakingUpdateScreen onConfirm={resolve} />)

package/src/input/modes/types.ts

@@ -52,6 +52,7 @@ export type SideEffect =
   | { type: 'apply-theme'; action: 'confirm' }
   | { type: 'apply-theme'; action: 'preview'; delta: 1 | -1 }
   | { type: 'rename-session'; sessionId: string; name: string }
+  | { type: 'rename-tab'; tabId: string; title: string }
   | {
       type: 'split-pane'
       direction: SplitDirection

package/src/ipc/manager-protocol.ts

@@ -32,8 +32,17 @@ import {
 // either way (pre-v7 TM → new client never sees the indices; new TM →
 // pre-v7 client ignores them and falls back to the theme default), so Min
 // is raised in lockstep to force matching binaries.
-export const MANAGER_PROTOCOL_MIN_VERSION = 8
-export const MANAGER_PROTOCOL_VERSION = 8
+//
+// v9: additive — `tabMetadata` updates titles and auto-rename state without
+// restarting PTYs. Capability-gated; MIN remains at 8.
+//
+// v10: additive — `workerName` persists a workspace-scoped orchestration
+// handle on tabs created through the headless worker facade.
+//
+// v11: breaking release boundary — force a fresh terminal-manager so named
+// worker metadata is guaranteed to survive daemon reattach and process swaps.
+export const MANAGER_PROTOCOL_MIN_VERSION = 11
+export const MANAGER_PROTOCOL_VERSION = 11
 
 /**
  * Capability strings advertised by *this* process in its `helloResult`. New
@@ -44,8 +53,13 @@ export const MANAGER_PROTOCOL_VERSION = 8
 export const MANAGER_PROTOCOL_CAPABILITIES: readonly string[] = [
   'setBroadcastEnabled',
   'createTabWorktreeId',
+  'tabMetadata',
+  'workerMetadata',
 ]
 
+export const MANAGER_CAPABILITY_TAB_METADATA = 'tabMetadata'
+export const MANAGER_CAPABILITY_WORKER_METADATA = 'workerMetadata'
+
 /**
  * Capability name a daemon must observe on the TM's helloResult before
  * sending `setBroadcastEnabled`.
@@ -119,9 +133,21 @@ export type ManagerRequest =
          * `worktreeId = undefined`.
          */
         worktreeId?: string
+        workerName?: string
+        autoRenameStatus?: 'eligible' | 'attempted'
       }
     }
   | { id: string; type: 'write'; payload: { sessionId: string; tabId: string; data: string } }
+  | {
+      id: string
+      type: 'updateTabMetadata'
+      payload: {
+        sessionId: string
+        tabId: string
+        title?: string
+        autoRenameStatus?: 'eligible' | 'attempted'
+      }
+    }
   | {
       id: string
       type: 'resizeClient'
@@ -364,12 +390,36 @@ export function parseManagerRequest(value: unknown): ManagerRequest {
         value.payload.worktreeId === undefined || isString(value.payload.worktreeId),
         'createTab.worktreeId must be a string when present'
       )
+      assert(
+        value.payload.workerName === undefined || isString(value.payload.workerName),
+        'createTab.workerName must be a string when present'
+      )
+      assert(
+        value.payload.autoRenameStatus === undefined ||
+          value.payload.autoRenameStatus === 'eligible' ||
+          value.payload.autoRenameStatus === 'attempted',
+        'createTab.autoRenameStatus is invalid'
+      )
       return value as ManagerRequest
     case 'write':
       assert(isString(value.payload.sessionId), 'write.sessionId must be a string')
       assert(isString(value.payload.tabId), 'write.tabId must be a string')
       assert(isString(value.payload.data), 'write.data must be a string')
       return value as ManagerRequest
+    case 'updateTabMetadata':
+      assert(isString(value.payload.sessionId), 'updateTabMetadata.sessionId must be a string')
+      assert(isString(value.payload.tabId), 'updateTabMetadata.tabId must be a string')
+      assert(
+        value.payload.title === undefined || isString(value.payload.title),
+        'updateTabMetadata.title must be a string when present'
+      )
+      assert(
+        value.payload.autoRenameStatus === undefined ||
+          value.payload.autoRenameStatus === 'eligible' ||
+          value.payload.autoRenameStatus === 'attempted',
+        'updateTabMetadata.autoRenameStatus is invalid'
+      )
+      return value as ManagerRequest
     case 'resizeClient':
       assert(isString(value.payload.sessionId), 'resizeClient.sessionId must be a string')
       assert(isFiniteNumber(value.payload.cols), 'resizeClient.cols must be a number')

package/src/ipc/protocol.ts

@@ -37,8 +37,17 @@ import { isWorkspaceSnapshotV1, isWorktreeRecord } from '../state/validation'
 // plus best-effort parsed options), and an additive `lastLine` field on
 // `TabSessionSummary`. Gated behind `turnLifecycle`, `questionEvents`, and
 // `listTabsLastLine` respectively; MIN stays at 10.
-export const IPC_PROTOCOL_MIN_VERSION = 10
-export const IPC_PROTOCOL_VERSION = 13
+//
+// v14: additive — tab metadata synchronization for manual and automatic
+// renames. The new request/event are capability-gated; MIN stays at 10.
+//
+// v15: additive — workspace-scoped `workerName` metadata on create, attach,
+// and list results. This powers stable name-or-id orchestration selectors.
+//
+// v16: breaking release boundary — the agent-first worker control plane and
+// its metadata guarantees are now required. Old app/daemon pairs must not mix.
+export const IPC_PROTOCOL_MIN_VERSION = 16
+export const IPC_PROTOCOL_VERSION = 16
 
 /**
  * Capability advertised by a daemon that knows how to drain + handoff its
@@ -103,6 +112,7 @@ export const IPC_CAPABILITY_WORKSPACE_LIFECYCLE = 'workspaceLifecycle'
  * fanout as workspaceLifecycle.
  */
 export const IPC_CAPABILITY_WORKTREE_LIFECYCLE_EVENTS = 'worktreeLifecycleEvents'
+export const IPC_CAPABILITY_WORKER_METADATA = 'workerMetadata'
 
 /**
  * v12 — capability marker for `aimux tab tail`. Functionally it's just a
@@ -137,6 +147,9 @@ export const IPC_CAPABILITY_QUESTION_EVENTS = 'questionEvents'
  */
 export const IPC_CAPABILITY_LIST_TABS_LAST_LINE = 'listTabsLastLine'
 
+/** Additive tab-title and auto-rename metadata synchronization. */
+export const IPC_CAPABILITY_TAB_METADATA = 'tabMetadata'
+
 /**
  * Capabilities advertised by *this* process in its `helloResult`. Additive
  * features should be introduced as new capability strings here rather than
@@ -160,6 +173,8 @@ export const IPC_PROTOCOL_CAPABILITIES: readonly string[] = [
   IPC_CAPABILITY_TURN_LIFECYCLE,
   IPC_CAPABILITY_QUESTION_EVENTS,
   IPC_CAPABILITY_LIST_TABS_LAST_LINE,
+  IPC_CAPABILITY_TAB_METADATA,
+  IPC_CAPABILITY_WORKER_METADATA,
 ]
 
 export interface ProtocolHelloRequest {
@@ -168,6 +183,8 @@ export interface ProtocolHelloRequest {
 }
 
 export interface ProtocolHelloResult {
+  /** aimux package version; absent on older daemons. */
+  appVersion?: string
   minVersion: number
   maxVersion: number
   processVersion: string
@@ -177,6 +194,8 @@ export interface ProtocolHelloResult {
    * not yet advertise capabilities are normalised to `[]` at parse time.
    */
   capabilities: string[]
+  /** Capabilities negotiated with the terminal-manager; absent on older daemons. */
+  managerCapabilities?: string[]
   /**
    * Manager-protocol version currently negotiated between the daemon and
    * its terminal-manager. `undefined` when the daemon has not yet connected
@@ -220,6 +239,7 @@ export interface TabSessionSummary {
   activity?: TabActivity
   command: string
   worktreeId?: string
+  workerName?: string
   /**
    * v13 / capability `listTabsLastLine`. The tab's last non-blank rendered
    * line, trimmed. Present only when the daemon advertises the capability;
@@ -269,9 +289,14 @@ export type ClientRequest =
          * only forwards it to the TM when its own capability is in play.
          */
         worktreeId?: string
+        /** v15 / capability `workerMetadata`: stable workspace-scoped handle. */
+        workerName?: string
+        /** True only when the creator did not provide an explicit title. */
+        autoRenameCandidate?: boolean
       }
     }
   | { id: string; type: 'write'; payload: { tabId: string; data: string } }
+  | { id: string; type: 'renameTab'; payload: { tabId: string; title: string } }
   | {
       id: string
       type: 'resizeClient'
@@ -395,6 +420,15 @@ export type ServerEvent =
       type: 'tabAdded'
       payload: { sessionId: string; tab: TabSession }
     }
+  | {
+      type: 'tabMetadataUpdated'
+      payload: {
+        sessionId: string
+        tabId: string
+        title?: string
+        autoRenameStatus?: 'eligible' | 'attempted'
+      }
+    }
   // v12 / capability `workspaceLifecycle`. Broadcast to every socket when a
   // CLI issues `createWorkspace` while a UI is attached — the UI runs its
   // create-session handler so the live workspace snapshot is preserved.
@@ -547,12 +581,14 @@ function isProtocolHelloResult(value: unknown): value is ProtocolHelloResult {
     isFiniteNumber(value.maxVersion) &&
     isFiniteNumber(value.selectedVersion) &&
     isString(value.processVersion) &&
+    (value.appVersion === undefined || isString(value.appVersion)) &&
     // Wire-back-compat: peers that predate the capabilities field omit it
     // entirely. parseServerMessage normalises that to `[]` before the cast
     // so the typed shape stays non-optional.
     (value.capabilities === undefined || isStringArray(value.capabilities)) &&
     // Additive: peers that predate managerSelectedVersion omit it.
-    (value.managerSelectedVersion === undefined || isFiniteNumber(value.managerSelectedVersion))
+    (value.managerSelectedVersion === undefined || isFiniteNumber(value.managerSelectedVersion)) &&
+    (value.managerCapabilities === undefined || isStringArray(value.managerCapabilities))
   )
 }
 
@@ -573,6 +609,7 @@ function isTabSessionSummary(value: unknown): value is TabSessionSummary {
       value.activity === 'idle') &&
     isString(value.command) &&
     (value.worktreeId === undefined || isString(value.worktreeId)) &&
+    (value.workerName === undefined || isString(value.workerName)) &&
     (value.lastLine === undefined || isString(value.lastLine))
   )
 }
@@ -608,6 +645,10 @@ function isTabSession(value: unknown): value is TabSession {
     isString(value.buffer) &&
     isTerminalModeState(value.terminalModes) &&
     isString(value.command) &&
+    (value.workerName === undefined || isString(value.workerName)) &&
+    (value.autoRenameStatus === undefined ||
+      value.autoRenameStatus === 'eligible' ||
+      value.autoRenameStatus === 'attempted') &&
     (value.viewport === undefined || isTerminalSnapshot(value.viewport)) &&
     (value.errorMessage === undefined || isString(value.errorMessage)) &&
     (value.exitCode === undefined || isFiniteNumber(value.exitCode)) &&
@@ -714,11 +755,27 @@ export function parseClientRequest(value: unknown): ClientRequest {
         value.payload.worktreeId === undefined || isString(value.payload.worktreeId),
         'createTab.worktreeId must be a string when present'
       )
+      assert(
+        value.payload.workerName === undefined || isString(value.payload.workerName),
+        'createTab.workerName must be a string when present'
+      )
+      assert(
+        value.payload.autoRenameCandidate === undefined ||
+          typeof value.payload.autoRenameCandidate === 'boolean',
+        'createTab.autoRenameCandidate must be a boolean when present'
+      )
       return value as ClientRequest
     case 'write':
       assert(isString(value.payload.tabId), 'write.tabId must be a string')
       assert(isString(value.payload.data), 'write.data must be a string')
       return value as ClientRequest
+    case 'renameTab':
+      assert(isString(value.payload.tabId), 'renameTab.tabId must be a string')
+      assert(
+        isString(value.payload.title) && value.payload.title.trim().length > 0,
+        'renameTab.title must be a non-empty string'
+      )
+      return value as ClientRequest
     case 'resizeClient':
       assert(isFiniteNumber(value.payload.cols), 'resizeClient.cols must be a number')
       assert(isFiniteNumber(value.payload.rows), 'resizeClient.rows must be a number')
@@ -872,6 +929,20 @@ export function parseServerMessage(value: unknown): ServerResponse | ServerEvent
       assert(isString(value.payload.sessionId), 'tabAdded.sessionId must be a string')
       assert(isTabSession(value.payload.tab), 'tabAdded.tab is invalid')
       return value as ServerEvent
+    case 'tabMetadataUpdated':
+      assert(isString(value.payload.sessionId), 'tabMetadataUpdated.sessionId must be a string')
+      assert(isString(value.payload.tabId), 'tabMetadataUpdated.tabId must be a string')
+      assert(
+        value.payload.title === undefined || isString(value.payload.title),
+        'tabMetadataUpdated.title must be a string when present'
+      )
+      assert(
+        value.payload.autoRenameStatus === undefined ||
+          value.payload.autoRenameStatus === 'eligible' ||
+          value.payload.autoRenameStatus === 'attempted',
+        'tabMetadataUpdated.autoRenameStatus is invalid'
+      )
+      return value as ServerEvent
     case 'sessionStatus':
       assert(isString(value.payload.sessionId), 'sessionStatus.sessionId must be a string')
       assert(isSessionStatus(value.payload.status), 'sessionStatus.status is invalid')

package/src/session-backend/bootstrap.ts

@@ -1,5 +1,6 @@
 import { connect } from 'node:net'
 
+import type { AutoRenameConfigSnapshot } from '../auto-rename/coordinator'
 import type { SessionBackend } from './types'
 
 import { negotiateDaemonReexec, waitForSocketRemoval } from '../daemon/reexec-client'
@@ -273,10 +274,11 @@ async function stopTerminalManager(): Promise<void> {
 
 export async function createSessionBackend(opts?: {
   onBreakingUpdateRequired?: () => Promise<void>
+  autoRenameConfig?: AutoRenameConfigSnapshot
 }): Promise<SessionBackend> {
   if (process.env.AIMUX_LOCAL_BACKEND === '1') {
     logDebug('backend.create.localExplicit')
-    return new LocalSessionBackend()
+    return new LocalSessionBackend(opts?.autoRenameConfig)
   }
 
   const socketPath = getIpcDaemonSocketPath()

package/src/session-backend/local-session-backend.ts

@@ -8,6 +8,11 @@ import type {
 } from '../state/types'
 import type { ResizeOptions, SessionBackend, SessionBackendEvents } from './types'
 
+import {
+  type AutoRenameConfigSnapshot,
+  AutoRenameCoordinator,
+  initialAutoRenameStatus,
+} from '../auto-rename/coordinator'
 import { SessionManager } from '../daemon/session-manager'
 import { logDebug } from '../debug/input-log'
 import { runStatusDetectionLoop } from '../pty/assistant-status-detection-loop'
@@ -40,9 +45,26 @@ export class LocalSessionBackend
     string,
     { viewport: TerminalSnapshot; terminalModes: TerminalModeState }
   >()
+  private readonly autoRename: AutoRenameCoordinator
+  private readonly autoRenameConfig: AutoRenameConfigSnapshot
 
-  constructor() {
+  constructor(
+    autoRenameConfig: AutoRenameConfigSnapshot = { enabled: false, models: {}, timeoutMs: 15_000 }
+  ) {
     super()
+    this.autoRenameConfig = autoRenameConfig
+    this.autoRename = new AutoRenameCoordinator({
+      config: autoRenameConfig,
+      getTab: (tabId) => this.findTab(tabId)?.tab,
+      updateTab: (tabId, patch) => {
+        const found = this.findTab(tabId)
+        if (!found) return
+        this.sessionManager.updateTabMetadata(found.sessionId, tabId, patch)
+        if (found.sessionId === this.currentSessionId) {
+          this.emit('tabMetadataUpdated', found.sessionId, tabId, patch)
+        }
+      },
+    })
     this.sessionManager.on('render', (sessionId, tabId, viewport, terminalModes) => {
       if (sessionId !== this.currentSessionId) return
       if (this.paneReady.get(tabId) === false) {
@@ -106,6 +128,7 @@ export class LocalSessionBackend
     )
     for (const tab of attachResult.tabs) {
       this.gatePaneRender(tab.id)
+      this.autoRename.register(tab)
     }
     // Run a synchronous classification pass so every tab's activity and the
     // session-status snapshot are available to embed in the reply — mirrors
@@ -133,6 +156,7 @@ export class LocalSessionBackend
     rows: number
     cwd?: string
     worktreeId?: string
+    autoRenameCandidate?: boolean
   }): void {
     if (!(this.currentSessionId != null && this.currentSessionId !== '')) {
       logDebug('backend.local.skipCreateWithoutSession', { tabId: options.tabId })
@@ -145,7 +169,14 @@ export class LocalSessionBackend
       worktreeId: options.worktreeId ?? null,
     })
     this.gatePaneRender(options.tabId)
-    this.sessionManager.createTab(this.currentSessionId, options)
+    const autoRenameStatus = initialAutoRenameStatus(
+      this.getAutoRenameConfig(),
+      options.assistant,
+      options.autoRenameCandidate === true
+    )
+    this.sessionManager.createTab(this.currentSessionId, { ...options, autoRenameStatus })
+    const tab = this.findTab(options.tabId)?.tab
+    if (tab) this.autoRename.register(tab)
   }
 
   /** Suppress render emission for this tab until the frontend acknowledges its
@@ -175,9 +206,21 @@ export class LocalSessionBackend
       sessionId: this.currentSessionId,
       tabId,
     })
+    this.autoRename.observeWrite(tabId, input)
     this.sessionManager.write(this.currentSessionId, tabId, input)
   }
 
+  renameTab(tabId: string, title: string): void {
+    const found = this.findTab(tabId)
+    if (!found) return
+    this.autoRename.manualRename(tabId)
+    const patch = { autoRenameStatus: 'attempted' as const, title }
+    this.sessionManager.updateTabMetadata(found.sessionId, tabId, patch)
+    if (found.sessionId === this.currentSessionId) {
+      this.emit('tabMetadataUpdated', found.sessionId, tabId, patch)
+    }
+  }
+
   scrollViewport(tabId: string, deltaLines: number): void {
     if (!(this.currentSessionId != null && this.currentSessionId !== '')) return
     this.sessionManager.scroll(this.currentSessionId, tabId, deltaLines)
@@ -212,6 +255,7 @@ export class LocalSessionBackend
     logDebug('backend.local.disposeSession', { sessionId: this.currentSessionId, tabId })
     this.paneReady.delete(tabId)
     this.pendingRender.delete(tabId)
+    this.autoRename.unregister(tabId)
     this.sessionManager.closeTab(this.currentSessionId, tabId)
   }
 
@@ -220,6 +264,9 @@ export class LocalSessionBackend
     logDebug('backend.local.disposeAll', { sessionId: this.currentSessionId })
     this.paneReady.clear()
     this.pendingRender.clear()
+    for (const tab of this.sessionManager.listTabs(this.currentSessionId)) {
+      this.autoRename.unregister(tab.id)
+    }
     this.sessionManager.disposeSession(this.currentSessionId)
   }
 
@@ -235,4 +282,18 @@ export class LocalSessionBackend
   announceWorkspaceSwitched(_sessionId: string): void {
     // No daemon on the local backend, so there's no CLI to notify.
   }
+
+  private findTab(
+    tabId: string
+  ): { sessionId: string; tab: ReturnType<SessionManager['listTabs']>[number] } | null {
+    for (const sessionId of this.sessionManager.listSessionIds()) {
+      const tab = this.sessionManager.listTabs(sessionId).find((entry) => entry.id === tabId)
+      if (tab) return { sessionId, tab }
+    }
+    return null
+  }
+
+  private getAutoRenameConfig(): AutoRenameConfigSnapshot {
+    return this.autoRenameConfig
+  }
 }

package/src/session-backend/remote-session-backend.ts

@@ -10,6 +10,7 @@ import {
   type AttachResult,
   type ClientRequest,
   encodeMessage,
+  IPC_CAPABILITY_TAB_METADATA,
   IPC_PROTOCOL_MIN_VERSION,
   IPC_PROTOCOL_VERSION,
   MessageDecoder,
@@ -211,6 +212,12 @@ export class RemoteSessionBackend
         })
         this.emit('tabAdded', message.payload.sessionId, message.payload.tab)
         break
+      case 'tabMetadataUpdated':
+        this.emit('tabMetadataUpdated', message.payload.sessionId, message.payload.tabId, {
+          autoRenameStatus: message.payload.autoRenameStatus,
+          title: message.payload.title,
+        })
+        break
       case 'workspaceCreateRequested':
         this.emit(
           'workspaceCreateRequested',
@@ -411,6 +418,7 @@ export class RemoteSessionBackend
     rows: number
     cwd?: string
     worktreeId?: string
+    autoRenameCandidate?: boolean
   }): void {
     if (!this.attached) {
       logDebug('backend.remote.skipCreateBeforeAttach', { tabId: options.tabId })
@@ -436,6 +444,15 @@ export class RemoteSessionBackend
     )
   }
 
+  renameTab(tabId: string, title: string): void {
+    if (!this.attached || !this.daemonAdvertises(IPC_CAPABILITY_TAB_METADATA)) return
+    this.dispatchCommand(
+      { id: crypto.randomUUID(), payload: { tabId, title }, type: 'renameTab' },
+      'renameTab',
+      tabId
+    )
+  }
+
   scrollViewport(tabId: string, deltaLines: number): void {
     if (!this.attached) {
       return

package/src/session-backend/types.ts

@@ -23,6 +23,11 @@ export interface SessionBackendEvents {
    * `tabRender` event lands.
    */
   tabAdded: [sessionId: string, tab: TabSession]
+  tabMetadataUpdated: [
+    sessionId: string,
+    tabId: string,
+    patch: { title?: string; autoRenameStatus?: 'eligible' | 'attempted' },
+  ]
   /**
    * v12 workspace-lifecycle events. Fired when a CLI issued
    * `createWorkspace` / `switchWorkspace` / `closeWorkspace` and the daemon
@@ -86,8 +91,10 @@ export interface SessionBackend extends EventEmitter<SessionBackendEvents> {
      *  registry surfaces the right grouping in `listTabs` for headless
      *  consumers (CLI control plane). */
     worktreeId?: string
+    autoRenameCandidate?: boolean
   }): void
   write(tabId: string, input: string): void
+  renameTab(tabId: string, title: string): void
   scrollViewport(tabId: string, deltaLines: number): void
   scrollViewportToBottom(tabId: string): void
   setActiveTab(tabId: string | null): void

package/src/state/reducers/tab-state.ts

@@ -543,7 +543,20 @@ export function reduceTabState(state: AppState, action: AppAction): AppState | n
     case 'rename-tab':
       return {
         ...state,
-        tabs: updateTab(state.tabs, action.tabId, (tab) => ({ ...tab, title: action.title })),
+        tabs: updateTab(state.tabs, action.tabId, (tab) => ({
+          ...tab,
+          autoRenameStatus: action.autoRenameStatus ?? tab.autoRenameStatus,
+          title: action.title,
+        })),
+      }
+    case 'update-tab-metadata':
+      return {
+        ...state,
+        tabs: updateTab(state.tabs, action.tabId, (tab) => ({
+          ...tab,
+          autoRenameStatus: action.autoRenameStatus ?? tab.autoRenameStatus,
+          title: action.title ?? tab.title,
+        })),
       }
     case 'split-pane': {
       if (!(state.activeTabId != null && state.activeTabId !== '')) {