@damper/cli 0.9.10 → 0.9.12

package/dist/index.js

@@ -5,7 +5,9 @@ import { statusCommand } from './commands/status.js';
 import { cleanupCommand } from './commands/cleanup.js';
 import { setupCommand } from './commands/setup.js';
 import { releaseCommand } from './commands/release.js';
-const VERSION = '0.6.7';
+import { createRequire } from 'node:module';
+const _require = createRequire(import.meta.url);
+const { version: VERSION } = _require('../package.json');
 function showHelp() {
     console.log(`
 ${pc.bold('@damper/cli')} - Agent orchestration for Damper tasks

package/dist/services/claude.js

@@ -4,7 +4,7 @@ import * as os from 'node:os';
 import { spawn } from 'node:child_process';
 import { execa } from 'execa';
 import pc from 'picocolors';
-import { shortIdRaw } from '../ui/format.js';
+import { shortIdRaw, setTerminalTitle, clearTerminalTitle, TerminalStatusBar } from '../ui/format.js';
 const CLAUDE_SETTINGS_DIR = path.join(os.homedir(), '.claude');
 const CLAUDE_SETTINGS_FILE = path.join(CLAUDE_SETTINGS_DIR, 'settings.json');
 /**
@@ -136,6 +136,11 @@ export async function launchClaude(options) {
         args = yolo ? ['--dangerously-skip-permissions', initialPrompt] : [initialPrompt];
         console.log(pc.dim(`Launching Claude in ${cwd}...`));
     }
+    // Set terminal title and bottom status bar
+    const taskLabel = `#${shortIdRaw(taskId)}: ${taskTitle}`;
+    setTerminalTitle(taskLabel);
+    const statusBar = new TerminalStatusBar(taskLabel);
+    statusBar.show();
     // Launch Claude Code
     // Use spawn with stdio: 'inherit' for proper TTY passthrough
     // Signals (Ctrl+C, Escape) are handled naturally since child inherits the terminal
@@ -158,6 +163,9 @@ export async function launchClaude(options) {
         });
         child.on('close', () => resolve());
     });
+    // Clean up status bar and terminal title
+    statusBar.hide();
+    clearTerminalTitle();
     console.log(pc.dim('\n─────────────────────────────────────────\n'));
     return { cwd, taskId, apiKey };
 }
@@ -539,6 +547,10 @@ export async function launchClaudeForReview(options) {
         '',
         'IMPORTANT: Do NOT make any code changes. This is a review-only session.',
     ].join('\n');
+    const reviewLabel = `Review #${shortIdRaw(taskId)}`;
+    setTerminalTitle(reviewLabel);
+    const statusBar = new TerminalStatusBar(reviewLabel);
+    statusBar.show();
     await new Promise((resolve) => {
         const child = spawn('claude', [prompt], {
             cwd,
@@ -548,6 +560,8 @@ export async function launchClaudeForReview(options) {
         child.on('error', () => resolve());
         child.on('close', () => resolve());
     });
+    statusBar.hide();
+    clearTerminalTitle();
 }
 /**
  * Launch Claude to resolve merge conflicts
@@ -557,6 +571,10 @@ export async function launchClaudeForReview(options) {
 async function launchClaudeForMerge(options) {
     const { cwd, apiKey } = options;
     const prompt = 'IMPORTANT: Your ONLY job is to resolve merge conflicts. Do NOT read TASK_CONTEXT.md or work on any task. Run: git merge origin/main --no-edit. If there are conflicts, resolve them, stage, and commit. Do not use any MCP tools.';
+    const mergeLabel = 'Resolving merge conflicts';
+    setTerminalTitle(mergeLabel);
+    const statusBar = new TerminalStatusBar(mergeLabel);
+    statusBar.show();
     await new Promise((resolve) => {
         const child = spawn('claude', ['--allowedTools', 'Bash,Read,Write,Edit,Glob,Grep', prompt], {
             cwd,
@@ -566,6 +584,8 @@ async function launchClaudeForMerge(options) {
         child.on('error', () => resolve());
         child.on('close', () => resolve());
     });
+    statusBar.hide();
+    clearTerminalTitle();
 }
 /**
  * Check if Claude Code CLI is installed

package/dist/ui/format.d.ts

@@ -35,6 +35,23 @@ export declare function formatSubtaskProgress(progress: {
 export declare function relativeTime(date: string | Date | null | undefined): string;
 /** Returns a picocolors function for the given status */
 export declare function statusColor(status: string): (s: string) => string;
+/** Set terminal tab/window title via ANSI escape sequence (OSC 0) */
+export declare function setTerminalTitle(title: string): void;
+/** Clear terminal title (restore default behavior) */
+export declare function clearTerminalTitle(): void;
+/**
+ * Persistent bottom status bar using ANSI scroll region (DECSTBM).
+ * Reserves the last terminal row for a fixed label while the child process
+ * operates inside the scroll region above it.
+ */
+export declare class TerminalStatusBar {
+    private title;
+    private handleResize;
+    constructor(title: string);
+    show(): void;
+    hide(): void;
+    private draw;
+}
 /** Terminal width (min 80) */
 export declare function getTerminalWidth(): number;
 /** Section header spanning terminal width: `── Label ───────────` */

package/dist/ui/format.js

@@ -144,6 +144,62 @@ export function statusColor(status) {
         default: return pc.dim;
     }
 }
+/** Set terminal tab/window title via ANSI escape sequence (OSC 0) */
+export function setTerminalTitle(title) {
+    if (process.stdout.isTTY) {
+        process.stdout.write(`\x1b]0;${title}\x07`);
+    }
+}
+/** Clear terminal title (restore default behavior) */
+export function clearTerminalTitle() {
+    if (process.stdout.isTTY) {
+        process.stdout.write(`\x1b]0;\x07`);
+    }
+}
+/**
+ * Persistent bottom status bar using ANSI scroll region (DECSTBM).
+ * Reserves the last terminal row for a fixed label while the child process
+ * operates inside the scroll region above it.
+ */
+export class TerminalStatusBar {
+    title;
+    handleResize = null;
+    constructor(title) {
+        this.title = title;
+    }
+    show() {
+        if (!process.stdout.isTTY)
+            return;
+        this.draw();
+        this.handleResize = () => this.draw();
+        process.stdout.on('resize', this.handleResize);
+    }
+    hide() {
+        if (!process.stdout.isTTY)
+            return;
+        if (this.handleResize) {
+            process.stdout.off('resize', this.handleResize);
+            this.handleResize = null;
+        }
+        const rows = process.stdout.rows || 24;
+        process.stdout.write('\x1b[r' + // Reset scroll region to full terminal
+            `\x1b[${rows};1H` + // Move to the status bar row
+            '\x1b[2K' // Clear the line
+        );
+    }
+    draw() {
+        const rows = process.stdout.rows || 24;
+        const cols = process.stdout.columns || 80;
+        const bar = ` ${this.title}`.padEnd(cols).slice(0, cols);
+        process.stdout.write('\x1b7' + // Save cursor position
+            `\x1b[${rows};1H` + // Move to last row
+            '\x1b[2K' + // Clear the line
+            '\x1b[7m' + bar + '\x1b[0m' + // Draw bar in inverse video
+            `\x1b[1;${rows - 1}r` + // Set scroll region above bar
+            '\x1b8' // Restore cursor position
+        );
+    }
+}
 /** Terminal width (min 80) */
 export function getTerminalWidth() {
     return Math.max(80, process.stdout.columns || 80);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damper/cli",
-  "version": "0.9.10",
+  "version": "0.9.12",
   "description": "CLI tool for orchestrating Damper task workflows with Claude Code",
   "author": "Damper <hello@usedamper.com>",
   "repository": {