feat: Add configurable terminal tab title

Sets the terminal tab title via OSC 1 escape sequence after each
status line render. Supports a template with placeholders:
{task}, {repo}, {branch}, {model}, {dir}.

Segments separated by ' | ' are dropped when all their placeholders
resolve to empty, so "{task} | {repo}/{branch}" gracefully falls
back to just "{repo}/{branch}" when no task is set.

Configuration in ~/.config/ccstatusline/settings.json:
  terminalTitle: { enabled: true, template: "{task} | {repo}/{branch}" }

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: m-mcgowan

src/ccstatusline.ts

@@ -28,6 +28,7 @@ import {
     renderStatusLine
 } from './utils/renderer';
 import { advanceGlobalSeparatorIndex } from './utils/separator-index';
+import { resolveTerminalTitle } from './utils/terminal-title';
 import {
     getSkillsFilePath,
     getSkillsMetrics
@@ -181,6 +182,16 @@ async function renderMultipleLines(data: StatusJSON) {
         }
     }
 
+    // Emit terminal tab title if configured
+    if (settings.terminalTitle.enabled) {
+        const title = resolveTerminalTitle(settings.terminalTitle.template, context);
+        if (title) {
+            // OSC 1 sets the terminal tab title; write to stderr to avoid
+            // interfering with the status line output on stdout
+            process.stderr.write(`\x1b]1;${title}\x07`);
+        }
+    }
+
     // Check if there's an update message to display
     if (settings.updatemessage?.message
         && settings.updatemessage.message.trim() !== ''

src/types/Settings.ts

@@ -58,6 +58,10 @@ export const SettingsSchema = z.object({
         theme: undefined,
         autoAlign: false
     }),
+    terminalTitle: z.object({
+        enabled: z.boolean().default(false),
+        template: z.string().default('{task} | {repo}/{branch}')
+    }).default({ enabled: false, template: '{task} | {repo}/{branch}' }),
     updatemessage: z.object({
         message: z.string().nullable().optional(),
         remaining: z.number().nullable().optional()

src/utils/terminal-title.ts

@@ -0,0 +1,64 @@
+import { readFileSync } from 'fs';
+import { basename, join } from 'path';
+
+import type { RenderContext } from '../types/RenderContext';
+import { getTaskDir } from '../widgets/TaskObjective';
+
+import { runGit } from './git';
+
+function getTaskFromFile(sessionId: string): string | null {
+    try {
+        const content = readFileSync(join(getTaskDir(), `claude-task-${sessionId}`), 'utf8').trim();
+        if (!content) return null;
+        try {
+            const data = JSON.parse(content) as { task?: string };
+            return data.task ?? null;
+        } catch {
+            return content.split('\n')[0] ?? null;
+        }
+    } catch {
+        return null;
+    }
+}
+
+/**
+ * Resolve a terminal title template string.
+ *
+ * Supported placeholders:
+ *   {task}   - task objective from the session task file
+ *   {repo}   - git repository name
+ *   {branch} - current git branch
+ *   {model}  - model display name
+ *   {dir}    - current working directory basename
+ *
+ * Segments separated by ' | ' are dropped if all their placeholders resolved
+ * to empty, so "Task: {task} | {repo}/{branch}" gracefully falls back to
+ * just "{repo}/{branch}" when no task is set.
+ */
+export function resolveTerminalTitle(template: string, context: RenderContext): string | null {
+    const sessionId = context.data?.session_id;
+    const task = sessionId ? getTaskFromFile(sessionId) : null;
+    const branch = runGit('branch --show-current', context);
+    const repoPath = runGit('rev-parse --show-toplevel', context);
+    const repo = repoPath ? basename(repoPath) : null;
+    const model = typeof context.data?.model === 'string'
+        ? context.data.model
+        : context.data?.model?.display_name ?? null;
+    const dir = context.data?.workspace?.current_dir
+        ? basename(context.data.workspace.current_dir)
+        : null;
+
+    const vars: Record<string, string | null> = {
+        task, repo, branch, model, dir
+    };
+
+    // Split by ' | ' segments, resolve each, drop empty segments
+    const segments = template.split(' | ').map(segment => {
+        const resolved = segment.replace(/\{(\w+)\}/g, (_, key: string) => vars[key] ?? '');
+        // If the segment is empty after resolving (all placeholders were empty), skip it
+        return resolved.trim();
+    }).filter(s => s.length > 0);
+
+    if (segments.length === 0) return null;
+    return segments.join(' | ');
+}

src/widgets/__tests__/CurrentWorkingDir.test.ts

@@ -48,6 +48,10 @@ describe('CurrentWorkingDirWidget', () => {
             startCaps: [],
             endCaps: [],
             autoAlign: false
+        },
+        terminalTitle: {
+            enabled: false,
+            template: '{task} | {repo}/{branch}'
         }
     };