santree 0.2.15 → 0.4.0

package/README.md

@@ -317,6 +317,15 @@ echo "$(date): $SANTREE_TICKET_ID waiting — $SANTREE_MESSAGE" >> /tmp/santree-
 
 Make it executable: `chmod +x .santree/hooks/on-waiting.sh`
 
+### Environment Variables
+
+| Variable | Effect |
+|---|---|
+| `SANTREE_EDITOR` | Editor used by `e` (open in editor) actions in the dashboard. Defaults to `code`. Examples: `cursor`, `zed`, `code`, `nvim`. |
+| `SANTREE_MULTIPLEXER` | Terminal multiplexer used by the dashboard and `worktree create --window`. One of `tmux`, `cmux`, `none`. If unset, auto-detects from `$TMUX` / `$CMUX_SURFACE_ID`. cmux is macOS-only and limited by [manaflow-ai/cmux#1472](https://github.com/manaflow-ai/cmux/issues/1472). |
+
+Santree always launches Claude with `--permission-mode auto` (Claude Code's auto mode), or `plan` when invoked in plan mode. Worktree-scoped automation is the default — there is no opt-in flag.
+
 ---
 
 ## Command Options

package/dist/commands/dashboard.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useReducer, useCallback, useRef, useState } from "react";
 import { Text, Box, useInput, useStdout, useApp } from "ink";
 import Spinner from "ink-spinner";
@@ -13,6 +13,7 @@ import { findMainRepoRoot, createWorktree, getDefaultBranch, getBaseBranch, hasI
 import { run, spawnAsync } from "../lib/exec.js";
 import { resolveAgentBinary } from "../lib/ai.js";
 import { extractTicketId } from "../lib/git.js";
+import { getMultiplexer } from "../lib/multiplexer/index.js";
 import { getPRTemplate } from "../lib/github.js";
 import { renderPrompt, renderDiff, renderTicket } from "../lib/prompts.js";
 import { getTicketContent } from "../lib/linear.js";
@@ -39,9 +40,6 @@ const CLAUDE_VERSION = (() => {
     }
 })();
 // ── Helpers ───────────────────────────────────────────────────────────
-function isInTmux() {
-    return !!process.env.TMUX;
-}
 function slugify(title) {
     return title
         .toLowerCase()
@@ -137,12 +135,7 @@ function ensureAltScreen() {
     if (altScreenEntered)
         return;
     altScreenEntered = true;
-    if (isInTmux()) {
-        try {
-            execSync('tmux rename-window "santree"', { stdio: "ignore" });
-        }
-        catch { }
-    }
+    getMultiplexer().renameWindow("", "santree");
     process.stdout.write("\x1b[?1049h"); // Enter alternate screen buffer
     process.stdout.write("\x1b[?25l"); // Hide cursor
 }
@@ -371,77 +364,95 @@ export default function Dashboard() {
     // ── Mouse tracking pause ─────────────────────────────────────────
     // The MultilineTextArea captures ESC for cancel. With SGR mouse tracking on,
     // every click emits `\x1b[<btn;col;rowM` — Ink reads the leading ESC and fires
-    // key.escape, dismissing the overlay. Disable mouse tracking while the
-    // context-input overlay is mounted; restore on unmount.
+    // key.escape, dismissing the overlay. Disable tracking while any overlay
+    // phase mounts a MultilineTextArea (context-input editing OR pr-create
+    // review); restore when that phase ends.
     useEffect(() => {
-        if (state.overlay !== "context-input")
+        const needsMouseOff = (state.overlay === "context-input" && state.contextInputPhase === "editing") ||
+            (state.overlay === "pr-create" && state.prCreatePhase === "review");
+        if (!needsMouseOff)
             return;
         process.stdout.write("\x1b[?1002l\x1b[?1006l");
         return () => {
             process.stdout.write("\x1b[?1002h\x1b[?1006h");
         };
-    }, [state.overlay]);
+    }, [state.overlay, state.contextInputPhase, state.prCreatePhase]);
     // ── Actions ───────────────────────────────────────────────────────
-    const launchWorkInTmux = useCallback((di, mode, worktreePath, contextFile) => {
+    const launchWorkInTmux = useCallback(async (di, mode, worktreePath, contextFile) => {
         const windowName = di.issue.identifier;
         const sessionId = di.worktree?.sessionId;
         const bin = resolveAgentBinary();
         const resumeCmd = sessionId && bin ? `${bin} --resume ${sessionId}` : null;
         const contextArg = contextFile ? ` --context-file "${contextFile}"` : "";
         const workCmd = mode === "plan" ? `st worktree work --plan${contextArg}` : `st worktree work${contextArg}`;
-        try {
-            // Switch to existing window if it exists
-            execSync(`tmux select-window -t "${windowName}"`, { stdio: "ignore" });
-            const cmd = resumeCmd ?? workCmd;
-            execSync(`tmux send-keys -t "${windowName}" "${cmd}" Enter`, { stdio: "ignore" });
-            dispatch({
-                type: "SET_ACTION_MESSAGE",
-                message: resumeCmd
-                    ? `Resumed session in: ${windowName}`
-                    : `Launched ${mode} in: ${windowName}`,
-            });
+        const cmd = resumeCmd ?? workCmd;
+        const mux = getMultiplexer();
+        const selected = await mux.selectWindow(windowName);
+        if (selected.ok) {
+            const sent = mux.sendCommand(windowName, cmd);
+            if (sent.ok) {
+                dispatch({
+                    type: "SET_ACTION_MESSAGE",
+                    message: resumeCmd
+                        ? `Resumed session in: ${windowName}`
+                        : `Launched ${mode} in: ${windowName}`,
+                });
+            }
+            else {
+                dispatch({
+                    type: "SET_ACTION_MESSAGE",
+                    message: `Focused ${windowName} — run \`${cmd}\` manually (${sent.reason})`,
+                });
+            }
         }
-        catch {
-            // Window doesn't exist — create it
-            try {
-                execSync(`tmux new-window -n "${windowName}" -c "${worktreePath}"`, { stdio: "ignore" });
-                // Small delay so the new shell can start reading input before we send keys,
-                // otherwise buffered keystrokes from the dashboard pane can leak in.
-                execSync("sleep 0.1", { stdio: "ignore" });
-                const cmd = resumeCmd ?? workCmd;
-                execSync(`tmux send-keys -t "${windowName}" "${cmd}" Enter`, { stdio: "ignore" });
+        else {
+            const created = await mux.createWindow({
+                name: windowName,
+                cwd: worktreePath,
+                command: cmd,
+            });
+            if (created.ok) {
                 dispatch({
                     type: "SET_ACTION_MESSAGE",
                     message: resumeCmd
                         ? `Resumed session in new window: ${windowName}`
-                        : `Launched ${mode} in tmux window: ${windowName}`,
+                        : `Launched ${mode} in ${mux.kind} window: ${windowName}`,
                 });
             }
-            catch {
-                dispatch({ type: "SET_ACTION_MESSAGE", message: "Failed to create tmux window" });
+            else {
+                dispatch({
+                    type: "SET_ACTION_MESSAGE",
+                    message: `Failed to create ${mux.kind} window${created.message ? `: ${created.message}` : ""}`,
+                });
             }
         }
         // Delayed refresh to pick up session ID created by `st worktree work`
         setTimeout(() => refresh(), 3000);
     }, [refresh]);
-    const launchAfterCreation = useCallback((mode, worktreePath, ticketId, contextFile) => {
-        if (isInTmux()) {
+    const launchAfterCreation = useCallback(async (mode, worktreePath, ticketId, contextFile) => {
+        const mux = getMultiplexer();
+        if (mux.isActive()) {
             const windowName = ticketId;
             const contextArg = contextFile ? ` --context-file "${contextFile}"` : "";
             const workCmd = mode === "plan"
                 ? `st worktree work --plan${contextArg}`
                 : `st worktree work${contextArg}`;
-            try {
-                execSync(`tmux new-window -n "${windowName}" -c "${worktreePath}"`, { stdio: "ignore" });
-                execSync("sleep 0.1", { stdio: "ignore" });
-                execSync(`tmux send-keys -t "${windowName}" "${workCmd}" Enter`, { stdio: "ignore" });
+            const created = await mux.createWindow({
+                name: windowName,
+                cwd: worktreePath,
+                command: workCmd,
+            });
+            if (created.ok) {
                 dispatch({
                     type: "SET_ACTION_MESSAGE",
                     message: `Created worktree + launched ${mode} in: ${windowName}`,
                 });
             }
-            catch {
-                dispatch({ type: "SET_ACTION_MESSAGE", message: "Worktree created, but tmux failed" });
+            else {
+                dispatch({
+                    type: "SET_ACTION_MESSAGE",
+                    message: `Worktree created, but ${mux.kind} failed${created.message ? `: ${created.message}` : ""}`,
+                });
             }
             setTimeout(() => refresh(), 3000);
         }
@@ -587,8 +598,8 @@ export default function Dashboard() {
         const contextFile = writeContextFile(customContext);
         if (di.worktree) {
             // Worktree exists — launch work
-            if (isInTmux()) {
-                launchWorkInTmux(di, mode, di.worktree.path, contextFile);
+            if (getMultiplexer().isActive()) {
+                void launchWorkInTmux(di, mode, di.worktree.path, contextFile);
             }
             else {
                 leaveAltScreen();
@@ -890,6 +901,9 @@ export default function Dashboard() {
         }
         // PR create overlay
         if (state.overlay === "pr-create") {
+            // Review phase — MultilineTextArea owns the keyboard
+            if (state.prCreatePhase === "review")
+                return;
             if (key.escape) {
                 dispatch({ type: "PR_CREATE_CANCEL" });
                 return;
@@ -904,21 +918,17 @@ export default function Dashboard() {
                     return;
                 }
             }
-            if (state.prCreatePhase === "review") {
+            if (state.prCreatePhase === "confirm") {
                 if (input === "y" || key.return) {
                     confirmPrCreate();
                     return;
                 }
-                if (input === "w") {
-                    openPrInWeb();
-                    return;
-                }
-                if (key.shift && key.downArrow) {
-                    dispatch({ type: "SCROLL_DETAIL", offset: state.detailScrollOffset + 3 });
+                if (input === "e") {
+                    dispatch({ type: "PR_CREATE_EDIT" });
                     return;
                 }
-                if (key.shift && key.upArrow) {
-                    dispatch({ type: "SCROLL_DETAIL", offset: Math.max(0, state.detailScrollOffset - 3) });
+                if (input === "w") {
+                    openPrInWeb();
                     return;
                 }
             }
@@ -1001,9 +1011,29 @@ export default function Dashboard() {
             }
             return;
         }
-        // Context-input overlay — MultilineTextArea owns its own useInput;
-        // outer useInput is disabled for this overlay via isActive below.
+        // Context-input overlay.
+        // Editing phase: MultilineTextArea owns useInput (outer is disabled
+        // via isActive below).
+        // Review phase: outer handles y/n/e/ESC.
         if (state.overlay === "context-input") {
+            if (state.contextInputPhase === "review") {
+                if (input === "y" || key.return) {
+                    const mode = state.contextInputMode;
+                    const ctx = state.contextInputValue;
+                    dispatch({ type: "CONTEXT_INPUT_DONE" });
+                    if (mode)
+                        doWork(mode, ctx);
+                    return;
+                }
+                if (input === "n" || input === "e") {
+                    dispatch({ type: "CONTEXT_INPUT_EDIT" });
+                    return;
+                }
+                if (key.escape) {
+                    dispatch({ type: "CONTEXT_INPUT_DONE" });
+                    return;
+                }
+            }
             return;
         }
         // Confirm delete overlay
@@ -1203,7 +1233,7 @@ export default function Dashboard() {
                 dispatch({ type: "SET_ACTION_MESSAGE", message: `Opened in ${editor}` });
                 return;
             }
-            // AI Review in tmux
+            // AI Review in multiplexer
             if (input === "r") {
                 if (!ri.worktree) {
                     dispatch({
@@ -1212,21 +1242,23 @@ export default function Dashboard() {
                     });
                     return;
                 }
-                if (isInTmux()) {
+                const mux = getMultiplexer();
+                if (mux.isActive()) {
                     const windowName = `review-${extractTicketId(ri.branch ?? "") ?? ri.pr.number}`;
-                    try {
-                        execSync(`tmux new-window -n "${windowName}" -c "${ri.worktree.path}"`, {
-                            stdio: "ignore",
+                    const cwd = ri.worktree.path;
+                    void (async () => {
+                        const created = await mux.createWindow({
+                            name: windowName,
+                            cwd,
+                            command: "st pr review",
                         });
-                        execSync("sleep 0.1", { stdio: "ignore" });
-                        execSync(`tmux send-keys -t "${windowName}" "st pr review" Enter`, {
-                            stdio: "ignore",
+                        dispatch({
+                            type: "SET_ACTION_MESSAGE",
+                            message: created.ok
+                                ? `Launched AI review in ${mux.kind}`
+                                : `Failed to launch review${created.message ? `: ${created.message}` : ""}`,
                         });
-                        dispatch({ type: "SET_ACTION_MESSAGE", message: "Launched AI review in tmux" });
-                    }
-                    catch {
-                        dispatch({ type: "SET_ACTION_MESSAGE", message: "Failed to launch review" });
-                    }
+                    })();
                 }
                 else {
                     leaveAltScreen();
@@ -1308,30 +1340,30 @@ export default function Dashboard() {
                 dispatch({ type: "SET_ACTION_MESSAGE", message: "No worktree to switch to" });
                 return;
             }
-            if (isInTmux()) {
+            const mux = getMultiplexer();
+            if (mux.isActive()) {
                 const windowName = di.issue.identifier;
                 const sessionId = di.worktree.sessionId;
                 const bin = resolveAgentBinary();
                 const resumeCmd = sessionId && bin ? `${bin} --resume ${sessionId}` : null;
-                try {
-                    execSync(`tmux select-window -t "${windowName}"`, { stdio: "ignore" });
-                }
-                catch {
-                    // Window doesn't exist — create one and resume/launch
-                    try {
-                        execSync(`tmux new-window -n "${windowName}" -c "${di.worktree.path}"`, {
-                            stdio: "ignore",
-                        });
-                        execSync("sleep 0.1", { stdio: "ignore" });
-                        const cmd = resumeCmd ?? "st worktree work";
-                        execSync(`tmux send-keys -t "${windowName}" "${cmd}" Enter`, {
-                            stdio: "ignore",
+                const worktreePath = di.worktree.path;
+                void (async () => {
+                    const selected = await mux.selectWindow(windowName);
+                    if (selected.ok)
+                        return;
+                    const cmd = resumeCmd ?? "st worktree work";
+                    const created = await mux.createWindow({
+                        name: windowName,
+                        cwd: worktreePath,
+                        command: cmd,
+                    });
+                    if (!created.ok) {
+                        dispatch({
+                            type: "SET_ACTION_MESSAGE",
+                            message: `Failed to switch ${mux.kind} window${created.message ? `: ${created.message}` : ""}`,
                         });
                     }
-                    catch {
-                        dispatch({ type: "SET_ACTION_MESSAGE", message: "Failed to switch tmux window" });
-                    }
-                }
+                })();
             }
             else {
                 leaveAltScreen();
@@ -1386,18 +1418,23 @@ export default function Dashboard() {
                 dispatch({ type: "SET_ACTION_MESSAGE", message: "No PR to review" });
                 return;
             }
-            if (isInTmux()) {
+            const mux = getMultiplexer();
+            if (mux.isActive()) {
                 const windowName = `review-${di.issue.identifier}`;
-                try {
-                    execSync(`tmux new-window -n "${windowName}" -c "${di.worktree.path}"`, {
-                        stdio: "ignore",
+                const cwd = di.worktree.path;
+                void (async () => {
+                    const created = await mux.createWindow({
+                        name: windowName,
+                        cwd,
+                        command: "st pr review",
                     });
-                    execSync(`tmux send-keys -t "${windowName}" "st pr review" Enter`, { stdio: "ignore" });
-                    dispatch({ type: "SET_ACTION_MESSAGE", message: "Launched review in tmux" });
-                }
-                catch {
-                    dispatch({ type: "SET_ACTION_MESSAGE", message: "Failed to launch review" });
-                }
+                    dispatch({
+                        type: "SET_ACTION_MESSAGE",
+                        message: created.ok
+                            ? `Launched review in ${mux.kind}`
+                            : `Failed to launch review${created.message ? `: ${created.message}` : ""}`,
+                    });
+                })();
             }
             else {
                 leaveAltScreen();
@@ -1445,18 +1482,23 @@ export default function Dashboard() {
                 dispatch({ type: "SET_ACTION_MESSAGE", message: "No PR to fix" });
                 return;
             }
-            if (isInTmux()) {
+            const mux = getMultiplexer();
+            if (mux.isActive()) {
                 const windowName = `fix-${di.issue.identifier}`;
-                try {
-                    execSync(`tmux new-window -n "${windowName}" -c "${di.worktree.path}"`, {
-                        stdio: "ignore",
+                const cwd = di.worktree.path;
+                void (async () => {
+                    const created = await mux.createWindow({
+                        name: windowName,
+                        cwd,
+                        command: "st pr fix",
                     });
-                    execSync(`tmux send-keys -t "${windowName}" "st pr fix" Enter`, { stdio: "ignore" });
-                    dispatch({ type: "SET_ACTION_MESSAGE", message: "Launched PR fix in tmux" });
-                }
-                catch {
-                    dispatch({ type: "SET_ACTION_MESSAGE", message: "Failed to launch PR fix" });
-                }
+                    dispatch({
+                        type: "SET_ACTION_MESSAGE",
+                        message: created.ok
+                            ? `Launched PR fix in ${mux.kind}`
+                            : `Failed to launch PR fix${created.message ? `: ${created.message}` : ""}`,
+                    });
+                })();
             }
             else {
                 leaveAltScreen();
@@ -1475,7 +1517,8 @@ export default function Dashboard() {
             return;
         }
     }, {
-        isActive: state.overlay !== "context-input" &&
+        isActive: (state.overlay !== "context-input" || state.contextInputPhase === "review") &&
+            (state.overlay !== "pr-create" || state.prCreatePhase !== "review") &&
             (state.overlay !== "commit" || state.commitPhase !== "awaiting-message"),
     });
     // ── Render ─────────────────────────────────────────────────────────
@@ -1487,13 +1530,10 @@ export default function Dashboard() {
     }
     const selectedIssue = state.flatIssues[state.selectedIndex] ?? null;
     const selectedReview = state.flatReviews[state.reviewSelectedIndex] ?? null;
-    return (_jsxs(Box, { width: columns, height: rows, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "Santree Dashboard" }), _jsxs(Text, { dimColor: true, children: ["  ", "v", version] }), CLAUDE_VERSION ? (_jsxs(Text, { dimColor: true, children: ["  ", "claude ", CLAUDE_VERSION] })) : null, _jsx(Text, { dimColor: true, children: state.refreshing ? "  refreshing..." : "" }), state.actionMessage && (_jsxs(Text, { color: "yellow", children: ["  ", state.actionMessage] }))] }), _jsxs(Box, { children: [_jsxs(Text, { bold: state.activeTab === "issues", color: state.activeTab === "issues" ? "cyan" : undefined, dimColor: state.activeTab !== "issues", children: [state.activeTab === "issues" ? "\u25b8 " : "  ", "1 Issues (", state.flatIssues.length, ")"] }), _jsx(Text, { children: "   " }), _jsxs(Text, { bold: state.activeTab === "reviews", color: state.activeTab === "reviews" ? "cyan" : undefined, dimColor: state.activeTab !== "reviews", children: [state.activeTab === "reviews" ? "\u25b8 " : "  ", "2 Reviews (", state.flatReviews.length, ")"] })] }), state.overlay === "mode-select" ? (_jsx(Box, { flexGrow: 1, justifyContent: "center", alignItems: "center", children: _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 3, paddingY: 1, children: [_jsx(Text, { bold: true, children: "Select mode:" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsx(Text, { color: "cyan", bold: true, children: "p" }), "  Plan"] }), _jsxs(Text, { children: [_jsx(Text, { color: "cyan", bold: true, children: "i" }), "  Implement"] }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "ESC to cancel" })] }) })) : state.overlay === "context-input" ? (_jsx(Box, { flexGrow: 1, justifyContent: "center", alignItems: "center", children: _jsxs(Box, { flexDirection: "column", paddingX: 2, children: [_jsxs(Text, { bold: true, color: "cyan", children: ["Extra context for ", state.contextInputMode] }), _jsx(Text, { dimColor: true, children: "Optional \u2014 appended to the prompt before launching Claude" }), _jsx(Text, { children: " " }), _jsx(MultilineTextArea, { value: state.contextInputValue, onChange: (v) => dispatch({ type: "CONTEXT_INPUT_CHANGE", value: v }), onSubmit: () => {
-                                const mode = state.contextInputMode;
-                                const ctx = state.contextInputValue;
-                                dispatch({ type: "CONTEXT_INPUT_DONE" });
-                                if (mode)
-                                    doWork(mode, ctx);
-                            }, onCancel: () => dispatch({ type: "CONTEXT_INPUT_DONE" }), width: Math.min(columns - 8, 100), height: 10, placeholder: "Type or paste extra context\u2026" }), _jsx(Text, { children: " " }), _jsxs(Text, { dimColor: true, children: [_jsx(Text, { color: "cyan", bold: true, children: "Ctrl+D" }), " ", "launch", "   ", _jsx(Text, { color: "cyan", bold: true, children: "Enter" }), " ", "newline", "   ", _jsx(Text, { color: "cyan", bold: true, children: "ESC" }), " ", "cancel"] })] }) })) : state.overlay === "base-select" ? (_jsx(Box, { flexGrow: 1, justifyContent: "center", alignItems: "center", children: _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 3, paddingY: 1, children: [_jsx(Text, { bold: true, children: "Select base branch:" }), _jsx(Text, { children: " " }), state.baseSelectOptions.map((branch, idx) => {
+    return (_jsxs(Box, { width: columns, height: rows, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "Santree Dashboard" }), _jsxs(Text, { dimColor: true, children: ["  ", "v", version] }), CLAUDE_VERSION ? (_jsxs(Text, { dimColor: true, children: ["  ", "claude ", CLAUDE_VERSION] })) : null, _jsx(Text, { dimColor: true, children: state.refreshing ? "  refreshing..." : "" }), state.actionMessage && (_jsxs(Text, { color: "yellow", children: ["  ", state.actionMessage] }))] }), _jsxs(Box, { children: [_jsxs(Text, { bold: state.activeTab === "issues", color: state.activeTab === "issues" ? "cyan" : undefined, dimColor: state.activeTab !== "issues", children: [state.activeTab === "issues" ? "\u25b8 " : "  ", "1 Issues (", state.flatIssues.length, ")"] }), _jsx(Text, { children: "   " }), _jsxs(Text, { bold: state.activeTab === "reviews", color: state.activeTab === "reviews" ? "cyan" : undefined, dimColor: state.activeTab !== "reviews", children: [state.activeTab === "reviews" ? "\u25b8 " : "  ", "2 Reviews (", state.flatReviews.length, ")"] })] }), state.overlay === "mode-select" ? (_jsx(Box, { flexGrow: 1, justifyContent: "center", alignItems: "center", children: _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 3, paddingY: 1, children: [_jsx(Text, { bold: true, children: "Select mode:" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsx(Text, { color: "cyan", bold: true, children: "p" }), "  Plan"] }), _jsxs(Text, { children: [_jsx(Text, { color: "cyan", bold: true, children: "i" }), "  Implement"] }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "ESC to cancel" })] }) })) : state.overlay === "context-input" ? (_jsx(Box, { flexGrow: 1, justifyContent: "center", alignItems: "center", children: _jsxs(Box, { flexDirection: "column", paddingX: 2, width: Math.min(columns - 8, 100), children: [_jsxs(Text, { bold: true, color: "cyan", children: ["Extra context for ", state.contextInputMode] }), _jsx(Text, { dimColor: true, children: "Optional \u2014 appended to the prompt before launching Claude" }), _jsx(Text, { children: " " }), state.contextInputPhase === "editing" ? (_jsxs(_Fragment, { children: [_jsx(MultilineTextArea, { value: state.contextInputValue, onChange: (v) => dispatch({ type: "CONTEXT_INPUT_CHANGE", value: v }), onSubmit: () => dispatch({ type: "CONTEXT_INPUT_REVIEW" }), onCancel: () => dispatch({ type: "CONTEXT_INPUT_DONE" }), width: Math.min(columns - 8, 100), height: 10, placeholder: "Type or paste extra context\u2026" }), _jsx(Text, { children: " " }), _jsxs(Text, { dimColor: true, children: [_jsx(Text, { color: "cyan", bold: true, children: "Ctrl+D" }), " send  ·  ", _jsx(Text, { color: "cyan", bold: true, children: "Ctrl+O" }), " editor  ·  ", _jsx(Text, { color: "cyan", bold: true, children: "Ctrl+C" }), " cancel"] })] })) : (_jsxs(_Fragment, { children: [_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "green", paddingX: 1, minHeight: 6, children: [(state.contextInputValue || "(no extra context)")
+                                            .split("\n")
+                                            .slice(0, 12)
+                                            .map((line, i) => (_jsx(Text, { children: line || " " }, i))), state.contextInputValue.split("\n").length > 12 && (_jsxs(Text, { dimColor: true, children: ["\u2026+", state.contextInputValue.split("\n").length - 12, " more lines"] }))] }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Anything else to add?" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsx(Text, { color: "green", bold: true, children: "y" }), " / ", _jsx(Text, { color: "green", bold: true, children: "Enter" }), "  launch   ", _jsx(Text, { color: "yellow", bold: true, children: "n" }), " / ", _jsx(Text, { color: "yellow", bold: true, children: "e" }), "  keep editing   ", _jsx(Text, { color: "red", bold: true, children: "ESC" }), "  cancel"] })] }))] }) })) : state.overlay === "base-select" ? (_jsx(Box, { flexGrow: 1, justifyContent: "center", alignItems: "center", children: _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 3, paddingY: 1, children: [_jsx(Text, { bold: true, children: "Select base branch:" }), _jsx(Text, { children: " " }), state.baseSelectOptions.map((branch, idx) => {
                             const selected = idx === state.baseSelectIndex;
                             const defaultBranch = getDefaultBranch();
                             const label = branch === defaultBranch ? `${branch} (default)` : branch;
@@ -1501,5 +1541,5 @@ export default function Dashboard() {
                         }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "j/k to navigate, Enter to select, ESC to cancel" })] }) })) : state.overlay === "confirm-delete" ? (_jsx(Box, { flexGrow: 1, justifyContent: "center", alignItems: "center", children: _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "red", paddingX: 3, paddingY: 1, children: [_jsx(Text, { bold: true, color: "red", children: "Remove worktree?" }), _jsx(Text, { children: " " }), _jsx(Text, { children: selectedIssue?.worktree?.branch ?? "" }), selectedIssue?.worktree?.dirty && (_jsx(Text, { color: "yellow", children: "Warning: worktree has uncommitted changes" })), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsx(Text, { color: "red", bold: true, children: "y" }), "  Confirm"] }), _jsxs(Text, { children: [_jsx(Text, { color: "cyan", bold: true, children: "n" }), "  Cancel"] })] }) })) : state.overlay === "confirm-setup" ? (_jsx(Box, { flexGrow: 1, justifyContent: "center", alignItems: "center", children: _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "yellow", paddingX: 3, paddingY: 1, children: [_jsx(Text, { bold: true, children: "Run setup script?" }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: ".santree/init.sh" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsx(Text, { color: "green", bold: true, children: "y" }), "  Run setup"] }), _jsxs(Text, { children: [_jsx(Text, { color: "yellow", bold: true, children: "n" }), "  Skip"] })] }) })) : (_jsxs(Box, { flexGrow: 1, children: [_jsx(Box, { width: leftWidth, children: state.activeTab === "reviews" ? (_jsx(ReviewList, { flatReviews: state.flatReviews, selectedIndex: state.reviewSelectedIndex, scrollOffset: state.reviewListScrollOffset, height: contentHeight, width: leftWidth })) : state.flatIssues.length === 0 ? (_jsx(Box, { width: leftWidth, height: contentHeight, justifyContent: "center", alignItems: "center", children: _jsx(Text, { color: "yellow", children: "No active issues" }) })) : (_jsx(IssueList, { groups: state.groups, flatIssues: state.flatIssues, selectedIndex: state.selectedIndex, scrollOffset: state.listScrollOffset, height: contentHeight, width: leftWidth, creatingForTicket: state.creatingForTicket, deletingForTicket: state.deletingForTicket })) }), _jsx(Box, { flexDirection: "column", width: 3, children: Array.from({ length: contentHeight }).map((_, i) => (_jsx(Text, { dimColor: true, children: " │ " }, i))) }), _jsx(Box, { width: rightWidth, children: state.activeTab === "reviews" && state.creatingForTicket ? (_jsxs(Box, { flexDirection: "column", width: rightWidth, height: contentHeight, children: [_jsxs(Text, { color: "yellow", bold: true, children: ["Setting up worktree for ", state.creatingForTicket, "..."] }), state.creationLogs
                                     .split("\n")
                                     .slice(-(contentHeight - 1))
-                                    .map((line, i) => (_jsx(Box, { children: _jsx(Text, { dimColor: true, children: line }) }, i)))] })) : state.activeTab === "reviews" ? (_jsx(ReviewDetailPanel, { item: selectedReview, scrollOffset: state.reviewDetailScrollOffset, height: contentHeight, width: rightWidth })) : state.overlay === "commit" ? (_jsx(CommitOverlay, { width: rightWidth, height: contentHeight, branch: state.commitBranch, ticketId: state.commitTicketId, gitStatus: state.commitGitStatus, phase: state.commitPhase, message: state.commitMessage, error: state.commitError, dispatch: dispatch, onSubmit: handleCommitSubmit })) : state.overlay === "pr-create" ? (_jsx(PrCreateOverlay, { width: rightWidth, height: contentHeight, branch: state.prCreateBranch, ticketId: state.prCreateTicketId, phase: state.prCreatePhase, error: state.prCreateError, url: state.prCreateUrl, body: state.prCreateBody, title: state.prCreateTitle, scrollOffset: state.detailScrollOffset })) : (_jsx(DetailPanel, { issue: selectedIssue, scrollOffset: state.detailScrollOffset, height: contentHeight, width: rightWidth, creatingForTicket: state.creatingForTicket, creationLogs: state.creationLogs })) })] }))] }));
+                                    .map((line, i) => (_jsx(Box, { children: _jsx(Text, { dimColor: true, children: line }) }, i)))] })) : state.activeTab === "reviews" ? (_jsx(ReviewDetailPanel, { item: selectedReview, scrollOffset: state.reviewDetailScrollOffset, height: contentHeight, width: rightWidth })) : state.overlay === "commit" ? (_jsx(CommitOverlay, { width: rightWidth, height: contentHeight, branch: state.commitBranch, ticketId: state.commitTicketId, gitStatus: state.commitGitStatus, phase: state.commitPhase, message: state.commitMessage, error: state.commitError, dispatch: dispatch, onSubmit: handleCommitSubmit })) : state.overlay === "pr-create" ? (_jsx(PrCreateOverlay, { width: rightWidth, height: contentHeight, branch: state.prCreateBranch, ticketId: state.prCreateTicketId, phase: state.prCreatePhase, error: state.prCreateError, url: state.prCreateUrl, body: state.prCreateBody, title: state.prCreateTitle, dispatch: dispatch })) : (_jsx(DetailPanel, { issue: selectedIssue, scrollOffset: state.detailScrollOffset, height: contentHeight, width: rightWidth, creatingForTicket: state.creatingForTicket, creationLogs: state.creationLogs })) })] }))] }));
 }

package/dist/commands/doctor.js

@@ -11,6 +11,7 @@ const require = createRequire(import.meta.url);
 const { version } = require("../../package.json");
 import { findMainRepoRoot, getSantreeDir, getInitScriptPath } from "../lib/git.js";
 import { getAuthStatus, getValidTokens } from "../lib/linear.js";
+import { getMultiplexer } from "../lib/multiplexer/index.js";
 const execAsync = promisify(exec);
 export const description = "Check system requirements and integrations";
 /**
@@ -55,6 +56,70 @@ async function checkTool(name, description, required, versionCommand, hint) {
         path,
     };
 }
+/**
+ * Reports the active multiplexer (tmux/cmux/none) and verifies the underlying
+ * binary is reachable. Surfaces a hint when the configured multiplexer can't run.
+ */
+async function checkMultiplexer() {
+    const mux = getMultiplexer();
+    const explicit = process.env["SANTREE_MULTIPLEXER"]?.toLowerCase();
+    const description = `Multiplexer (active: ${mux.kind}${explicit ? `, SANTREE_MULTIPLEXER=${explicit}` : ""})`;
+    if (mux.kind === "none") {
+        return {
+            name: "multiplexer",
+            description,
+            required: false,
+            installed: false,
+            hint: "No multiplexer active. Set SANTREE_MULTIPLEXER=tmux (or cmux) and run inside one. Install: brew install tmux",
+        };
+    }
+    if (mux.kind === "tmux") {
+        const path = await getPath("tmux");
+        if (!path) {
+            return {
+                name: "tmux",
+                description,
+                required: false,
+                installed: false,
+                hint: "Install: brew install tmux",
+            };
+        }
+        const version = await tryExec("tmux -V");
+        return {
+            name: "tmux",
+            description,
+            required: false,
+            installed: true,
+            version: version || "unknown",
+            path,
+        };
+    }
+    // cmux
+    const path = await getPath("cmux");
+    if (!path) {
+        return {
+            name: "cmux",
+            description,
+            required: false,
+            installed: false,
+            hint: "Install cmux.app from https://cmux.com or set SANTREE_MULTIPLEXER=tmux. cmux is macOS-only.",
+        };
+    }
+    const version = await tryExec("cmux --version 2>/dev/null");
+    const ping = await tryExec("cmux ping 2>/dev/null");
+    const hint = !ping
+        ? "cmux app not reachable — open cmux.app or set SANTREE_MULTIPLEXER=tmux. NOTE: cmux #1472 — programmatic workspaces may have dead PTYs (https://github.com/manaflow-ai/cmux/issues/1472)."
+        : "NOTE: cmux #1472 — programmatic workspaces may have dead PTYs (https://github.com/manaflow-ai/cmux/issues/1472).";
+    return {
+        name: "cmux",
+        description,
+        required: false,
+        installed: !!ping,
+        version: version || "unknown",
+        path,
+        hint,
+    };
+}
 /**
  * Checks GitHub CLI auth status.
  * Uses `gh api user` which works across all gh versions.
@@ -399,7 +464,7 @@ export default function Doctor() {
             const results = await Promise.all([
                 checkTool("git", "Version control", true, "git --version | head -1", "Install: brew install git"),
                 checkGhAuth(),
-                checkTool("tmux", "Terminal multiplexer", false, "tmux -V", "Install: brew install tmux"),
+                checkMultiplexer(),
                 checkTool("claude", "Claude Code CLI", true, "claude --version 2>/dev/null | head -1", "Install: npm install -g @anthropic-ai/claude-code"),
             ]);
             // Check for either code or cursor (only need one)

package/dist/commands/helpers/text-editor.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod/v4";
+export declare const description = "Open $EDITOR on a temp file, then print the path on stdout (compose with --context-file).";
+export declare const options: z.ZodObject<{
+    initial: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodString>;
+    ext: z.ZodDefault<z.ZodString>;
+    editor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Props = {
+    options: z.infer<typeof options>;
+};
+export default function TextEditor({ options: opts }: Props): null;
+export {};