@damper/cli 0.9.13 → 0.9.15

package/dist/commands/start.js

@@ -5,7 +5,7 @@ import { createWorktree, getMainProjectRoot, removeWorktreeDir } from '../servic
 import { bootstrapContext, refreshContext } from '../services/context-bootstrap.js';
 import { pickTask } from '../ui/task-picker.js';
 import { launchClaude, launchClaudeForReview, postTaskFlow, isClaudeInstalled, isDamperMcpConfigured, configureDamperMcp } from '../services/claude.js';
-import { getWorktreesForProject, cleanupStaleWorktrees } from '../services/state.js';
+import { getWorktreesForProject, cleanupStaleWorktrees, getPreference, setPreference } from '../services/state.js';
 import { getApiKey, isProjectConfigured, getProjectConfigPath } from '../services/config.js';
 import { shortIdRaw } from '../ui/format.js';
 export async function startCommand(options) {
@@ -39,6 +39,8 @@ export async function startCommand(options) {
         }
         process.exit(1);
     }
+    // Check if tmux is installed (enables persistent task title bar)
+    await ensureTmux();
     // Ensure MCP is configured globally (without key - key comes from env)
     if (!isDamperMcpConfigured()) {
         console.log(pc.dim('Configuring Damper MCP...'));
@@ -310,3 +312,77 @@ async function handleReviewAndComplete(options) {
     }
     console.log();
 }
+/**
+ * Check if tmux is installed; offer to install or recommend it if not.
+ * Skipped if the user previously dismissed the prompt.
+ */
+async function ensureTmux() {
+    // Already dismissed?
+    if (getPreference('tmuxPromptDismissed'))
+        return;
+    // Already installed?
+    try {
+        const { execa } = await import('execa');
+        await execa('tmux', ['-V'], { stdio: 'pipe' });
+        return; // tmux is available
+    }
+    catch {
+        // not installed — continue
+    }
+    // Check if brew is available
+    let hasBrew = false;
+    try {
+        const { execa } = await import('execa');
+        await execa('brew', ['--version'], { stdio: 'pipe' });
+        hasBrew = true;
+    }
+    catch {
+        // no brew
+    }
+    console.log(pc.yellow('\n⚠ tmux not found'));
+    console.log(pc.dim('  tmux enables a persistent task title bar while Claude runs.'));
+    if (hasBrew) {
+        const { select } = await import('@inquirer/prompts');
+        const action = await select({
+            message: 'Install tmux via Homebrew?',
+            choices: [
+                { name: 'Install now (brew install tmux)', value: 'install' },
+                { name: 'Skip for now', value: 'skip' },
+                { name: "Don't ask again", value: 'dismiss' },
+            ],
+        });
+        if (action === 'install') {
+            console.log(pc.dim('\nInstalling tmux...'));
+            try {
+                const { execa } = await import('execa');
+                await execa('brew', ['install', 'tmux'], { stdio: 'inherit' });
+                console.log(pc.green('✓ tmux installed\n'));
+            }
+            catch {
+                console.log(pc.red('Failed to install tmux. You can install it manually: brew install tmux\n'));
+            }
+        }
+        else if (action === 'dismiss') {
+            setPreference('tmuxPromptDismissed', true);
+            console.log(pc.dim('You can install it later: brew install tmux\n'));
+        }
+        else {
+            console.log(pc.dim('Continuing without tmux.\n'));
+        }
+    }
+    else {
+        console.log(pc.dim('  Install it with: brew install tmux'));
+        console.log(pc.dim('  Or see: https://github.com/tmux/tmux/wiki/Installing\n'));
+        const { select } = await import('@inquirer/prompts');
+        const action = await select({
+            message: 'What would you like to do?',
+            choices: [
+                { name: 'Continue without tmux', value: 'skip' },
+                { name: "Don't remind me again", value: 'dismiss' },
+            ],
+        });
+        if (action === 'dismiss') {
+            setPreference('tmuxPromptDismissed', true);
+        }
+    }
+}

package/dist/services/claude.js

@@ -81,6 +81,25 @@ export function configureDamperMcp() {
     // Write back
     fs.writeFileSync(CLAUDE_SETTINGS_FILE, JSON.stringify(settings, null, 2));
 }
+/**
+ * Send a notification when Claude finishes.
+ * - BEL: triggers terminal bell (Ghostty: sound + dock badge)
+ * - macOS notification: shows a system banner via osascript
+ */
+function notifySessionEnd(label) {
+    // Terminal bell — triggers Ghostty sound/badge, works in any terminal
+    if (process.stdout.isTTY) {
+        process.stdout.write('\x07');
+    }
+    // macOS desktop notification (fire-and-forget)
+    if (process.platform === 'darwin') {
+        const escaped = label.replace(/"/g, '\\"');
+        spawn('osascript', [
+            '-e',
+            `display notification "${escaped}" with title "Damper" sound name "Glass"`,
+        ], { stdio: 'ignore', detached: true }).unref();
+    }
+}
 /**
  * Check if tmux is available
  */
@@ -229,6 +248,7 @@ export async function launchClaude(options) {
         });
     }
     clearTerminalTitle();
+    notifySessionEnd(`Claude finished: ${taskLabel}`);
     console.log(pc.dim('\n─────────────────────────────────────────\n'));
     return { cwd, taskId, apiKey };
 }
@@ -634,6 +654,7 @@ export async function launchClaudeForReview(options) {
         });
     }
     clearTerminalTitle();
+    notifySessionEnd(`Review finished: ${reviewLabel}`);
 }
 /**
  * Launch Claude to resolve merge conflicts
@@ -667,6 +688,7 @@ async function launchClaudeForMerge(options) {
         });
     }
     clearTerminalTitle();
+    notifySessionEnd('Merge conflict resolution finished');
 }
 /**
  * Check if Claude Code CLI is installed

package/dist/services/state.d.ts

@@ -13,3 +13,10 @@ export declare function removeWorktree(taskId: string): void;
 export declare function removeWorktreeByPath(worktreePath: string): void;
 export declare function cleanupStaleWorktrees(): WorktreeState[];
 export declare function getWorktreesForProject(projectRoot: string): WorktreeState[];
+interface Preferences {
+    tmuxPromptDismissed?: boolean;
+    [key: string]: unknown;
+}
+export declare function getPreference<K extends keyof Preferences>(key: K): Preferences[K];
+export declare function setPreference<K extends keyof Preferences>(key: K, value: Preferences[K]): void;
+export {};

package/dist/services/state.js

@@ -75,3 +75,28 @@ export function getWorktreesForProject(projectRoot) {
     const normalized = path.resolve(projectRoot);
     return readState().worktrees.filter(w => path.resolve(w.projectRoot) === normalized);
 }
+// ── Preferences (persistent user choices) ──
+const PREFS_FILE = path.join(STATE_DIR, 'preferences.json');
+function readPrefs() {
+    ensureStateDir();
+    if (!fs.existsSync(PREFS_FILE))
+        return {};
+    try {
+        return JSON.parse(fs.readFileSync(PREFS_FILE, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writePrefs(prefs) {
+    ensureStateDir();
+    fs.writeFileSync(PREFS_FILE, JSON.stringify(prefs, null, 2));
+}
+export function getPreference(key) {
+    return readPrefs()[key];
+}
+export function setPreference(key, value) {
+    const prefs = readPrefs();
+    prefs[key] = value;
+    writePrefs(prefs);
+}

package/package.json

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