santree 0.2.15 → 0.4.0

package/dist/lib/dashboard/Overlays.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { Box, Text } from "ink";
 import Spinner from "ink-spinner";
 import TextInput from "ink-text-input";
+import { MultilineTextArea } from "./MultilineTextArea.js";
 export function CommitOverlay({ width, height, branch, ticketId, gitStatus, phase, message, error, dispatch, onSubmit, }) {
     return (_jsxs(Box, { flexDirection: "column", width: width, height: height, children: [_jsx(Text, { bold: true, color: "cyan", children: "Commit & Push" }), _jsx(Text, { dimColor: true, children: "─".repeat(Math.min(width, 50)) }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "branch: " }), _jsx(Text, { children: branch })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "ticket: " }), _jsx(Text, { children: ticketId })] }), _jsx(Text, { children: " " }), gitStatus ? (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: "Changes:" }), gitStatus
                         .split("\n")
@@ -20,9 +21,9 @@ export function CommitOverlay({ width, height, branch, ticketId, gitStatus, phas
                         return (_jsxs(Text, { color: color, children: [" ", line] }, i));
                     }), gitStatus.split("\n").length > 8 && (_jsxs(Text, { dimColor: true, children: [" +", gitStatus.split("\n").length - 8, " more"] }))] })) : null, _jsx(Text, { children: " " }), phase === "confirm-stage" && (_jsxs(Text, { children: ["Stage all changes?", " ", _jsx(Text, { color: "cyan", bold: true, children: "y" }), "/", _jsx(Text, { color: "cyan", bold: true, children: "n" })] })), phase === "awaiting-message" && (_jsxs(Box, { children: [_jsx(Text, { children: "Message: " }), _jsx(TextInput, { value: message, onChange: (v) => dispatch({ type: "COMMIT_MESSAGE", message: v }), onSubmit: onSubmit })] })), phase === "committing" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Committing..."] })), phase === "pushing" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Pushing..."] })), phase === "done" && (_jsx(Text, { color: "green", bold: true, children: "Committed and pushed!" })), phase === "error" && _jsx(Text, { color: "red", children: error }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "ESC to cancel" })] }));
 }
-export function PrCreateOverlay({ width, height, branch, ticketId, phase, error, url, body, title, scrollOffset, }) {
-    return (_jsxs(Box, { flexDirection: "column", width: width, height: height, children: [_jsx(Text, { bold: true, color: "cyan", children: "Create Pull Request" }), _jsx(Text, { dimColor: true, children: "─".repeat(Math.min(width, 50)) }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "branch: " }), _jsx(Text, { children: branch })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "ticket: " }), _jsx(Text, { children: ticketId })] }), _jsx(Text, { children: " " }), phase === "choose-mode" && (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: "How do you want to create this PR?" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [" ", _jsx(Text, { color: "cyan", bold: true, children: "f" }), " ", "Fill \u2014 use AI to fill the PR template"] }), _jsxs(Text, { children: [" ", _jsx(Text, { color: "cyan", bold: true, children: "w" }), " ", "Web \u2014 open in browser to edit manually"] })] })), phase === "pushing" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Pushing branch..."] })), phase === "filling" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Filling PR template with AI..."] })), phase === "review" && (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: "Review PR" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "title: " }), _jsx(Text, { children: title })] }), _jsx(Text, { children: " " }), body
-                        ?.split("\n")
-                        .slice(scrollOffset, scrollOffset + height - 11)
-                        .map((line, i) => (_jsx(Text, { wrap: "truncate", children: line }, i))), _jsx(Text, { children: " " }), _jsxs(Text, { dimColor: true, children: [_jsx(Text, { color: "cyan", bold: true, children: "y" }), "/Enter create", " ", _jsx(Text, { color: "cyan", bold: true, children: "w" }), " ", "open in browser ESC cancel Shift+arrows scroll"] })] })), phase === "creating" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Creating PR..."] })), phase === "done" && (_jsxs(_Fragment, { children: [_jsx(Text, { color: "green", bold: true, children: "PR created!" }), url ? _jsx(Text, { dimColor: true, children: url }) : null] })), phase === "error" && (_jsxs(_Fragment, { children: [_jsx(Text, { color: "red", children: error }), _jsx(Text, { children: " " }), _jsxs(Text, { dimColor: true, children: [_jsx(Text, { color: "cyan", bold: true, children: "w" }), " ", "open in browser ESC cancel"] })] })), phase !== "review" && phase !== "error" && (_jsxs(_Fragment, { children: [_jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "ESC to cancel" })] }))] }));
+export function PrCreateOverlay({ width, height, branch, ticketId, phase, error, url, body, title, dispatch, }) {
+    return (_jsxs(Box, { flexDirection: "column", width: width, height: height, children: [_jsx(Text, { bold: true, color: "cyan", children: "Create Pull Request" }), _jsx(Text, { dimColor: true, children: "─".repeat(Math.min(width, 50)) }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "branch: " }), _jsx(Text, { children: branch })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "ticket: " }), _jsx(Text, { children: ticketId })] }), _jsx(Text, { children: " " }), phase === "choose-mode" && (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: "How do you want to create this PR?" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [" ", _jsx(Text, { color: "cyan", bold: true, children: "f" }), " ", "Fill \u2014 use AI to fill the PR template"] }), _jsxs(Text, { children: [" ", _jsx(Text, { color: "cyan", bold: true, children: "w" }), " ", "Web \u2014 open in browser to edit manually"] })] })), phase === "pushing" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Pushing branch..."] })), phase === "filling" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Filling PR template with AI..."] })), phase === "review" && (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: "Edit PR description" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "title: " }), _jsx(Text, { children: title })] }), _jsx(Text, { children: " " }), _jsx(MultilineTextArea, { value: body ?? "", onChange: (v) => dispatch({ type: "PR_CREATE_BODY_CHANGE", body: v }), onSubmit: () => dispatch({ type: "PR_CREATE_CONFIRM" }), onCancel: () => dispatch({ type: "PR_CREATE_CANCEL" }), width: width, height: Math.max(6, height - 10), placeholder: "(empty PR body)" }), _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"] })] })), phase === "confirm" && (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: "Create this PR?" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "title: " }), _jsx(Text, { children: title })] }), _jsx(Text, { children: " " }), _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "green", paddingX: 1, children: [(body ?? "")
+                                .split("\n")
+                                .slice(0, Math.max(4, height - 12))
+                                .map((line, i) => (_jsx(Text, { wrap: "truncate", children: line || " " }, i))), (body ?? "").split("\n").length > Math.max(4, height - 12) && (_jsxs(Text, { dimColor: true, children: ["\u2026+", (body ?? "").split("\n").length - Math.max(4, height - 12), " more lines"] }))] }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsx(Text, { color: "green", bold: true, children: "y" }), " / ", _jsx(Text, { color: "green", bold: true, children: "Enter" }), "  create   ", _jsx(Text, { color: "yellow", bold: true, children: "e" }), "  keep editing   ", _jsx(Text, { color: "cyan", bold: true, children: "w" }), "  open in browser   ", _jsx(Text, { color: "red", bold: true, children: "ESC" }), "  cancel"] })] })), phase === "creating" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Creating PR..."] })), phase === "done" && (_jsxs(_Fragment, { children: [_jsx(Text, { color: "green", bold: true, children: "PR created!" }), url ? _jsx(Text, { dimColor: true, children: url }) : null] })), phase === "error" && (_jsxs(_Fragment, { children: [_jsx(Text, { color: "red", children: error }), _jsx(Text, { children: " " }), _jsxs(Text, { dimColor: true, children: [_jsx(Text, { color: "cyan", bold: true, children: "w" }), " ", "open in browser ESC cancel"] })] })), phase !== "review" && phase !== "confirm" && phase !== "error" && (_jsxs(_Fragment, { children: [_jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "ESC to cancel" })] }))] }));
 }

package/dist/lib/dashboard/data.js

@@ -1,4 +1,4 @@
-import { listWorktrees, extractTicketId, getBaseBranch, readAllMetadata, readSessionState, isSessionAliveInTmux, clearSessionState, getGitStatusAsync, getCommitsAheadAsync, } from "../git.js";
+import { listWorktrees, extractTicketId, getBaseBranch, readAllMetadata, readSessionState, isSessionAlive, clearSessionState, getGitStatusAsync, getCommitsAheadAsync, } from "../git.js";
 import { getPRInfoAsync, getPRChecksAsync, getPRReviewsAsync, getPRConversationCommentsAsync, getPRViewAsync, getReviewRequestedPRsAsync, getRepoNameAsync, } from "../github.js";
 import { fetchAssignedIssues } from "../linear.js";
 export async function loadDashboardData(repoRoot) {
@@ -39,8 +39,8 @@ export async function loadDashboardData(repoRoot) {
                 getPRInfoAsync(wt.branch),
             ]);
             let sessState = readSessionState(repoRoot, issue.identifier);
-            // Validate against tmux — if no claude process is running, clear stale state
-            if (sessState && !isSessionAliveInTmux(issue.identifier)) {
+            // Validate against the active multiplexer — if the session has gone, clear stale state
+            if (sessState && !isSessionAlive(issue.identifier)) {
                 clearSessionState(repoRoot, issue.identifier);
                 sessState = null;
             }
@@ -96,7 +96,7 @@ export async function loadDashboardData(repoRoot) {
             .replace(/-/g, " ")
             .trim() || tid;
         let sessState = readSessionState(repoRoot, tid);
-        if (sessState && !isSessionAliveInTmux(tid)) {
+        if (sessState && !isSessionAlive(tid)) {
             clearSessionState(repoRoot, tid);
             sessState = null;
         }
@@ -260,7 +260,7 @@ export async function loadReviewsData(repoRoot) {
                     getCommitsAheadAsync(wt.path, base),
                 ]);
                 let sessState = ticketId ? readSessionState(repoRoot, ticketId) : null;
-                if (sessState && ticketId && !isSessionAliveInTmux(ticketId)) {
+                if (sessState && ticketId && !isSessionAlive(ticketId)) {
                     clearSessionState(repoRoot, ticketId);
                     sessState = null;
                 }

package/dist/lib/dashboard/external-editor.d.ts

@@ -0,0 +1,12 @@
+export interface EditExternallyResult {
+    ok: boolean;
+    content: string;
+    cancelled: boolean;
+}
+/**
+ * Open the user's editor on a temp file seeded with `initial`, then return the
+ * saved content. Empty buffer is treated as cancel (matches `git commit`).
+ *
+ * Editor resolution: SANTREE_EDITOR > VISUAL > EDITOR > "vim".
+ */
+export declare function editExternally(initial: string, ext?: string): EditExternallyResult;

package/dist/lib/dashboard/external-editor.js

@@ -0,0 +1,74 @@
+import { spawnSync } from "child_process";
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+// GUI editors that detach by default and need a `--wait` flag to make spawnSync
+// block until the file is closed. Terminal editors (vim, nvim, nano, emacs -nw)
+// already block, so they aren't listed here.
+const GUI_EDITORS_NEEDING_WAIT = new Set([
+    "zed",
+    "code",
+    "code-insiders",
+    "cursor",
+    "windsurf",
+    "subl",
+]);
+/**
+ * Open the user's editor on a temp file seeded with `initial`, then return the
+ * saved content. Empty buffer is treated as cancel (matches `git commit`).
+ *
+ * Editor resolution: SANTREE_EDITOR > VISUAL > EDITOR > "vim".
+ */
+export function editExternally(initial, ext = "md") {
+    const editorRaw = process.env["SANTREE_EDITOR"] || process.env["VISUAL"] || process.env["EDITOR"] || "vim";
+    const filePath = path.join(os.tmpdir(), `santree-edit-${Date.now()}.${ext.replace(/^\./, "")}`);
+    try {
+        fs.writeFileSync(filePath, initial);
+    }
+    catch {
+        return { ok: false, content: initial, cancelled: false };
+    }
+    const parts = editorRaw.split(/\s+/).filter(Boolean);
+    const cmd = parts[0] ?? "vim";
+    const baseArgs = parts.slice(1);
+    const needsWait = GUI_EDITORS_NEEDING_WAIT.has(path.basename(cmd)) &&
+        !baseArgs.includes("--wait") &&
+        !baseArgs.includes("-w");
+    const args = [...baseArgs, ...(needsWait ? ["--wait"] : []), filePath];
+    const wasRaw = process.stdin.isTTY ? process.stdin.isRaw : false;
+    if (process.stdin.isTTY && process.stdin.setRawMode) {
+        try {
+            process.stdin.setRawMode(false);
+        }
+        catch { }
+    }
+    const result = spawnSync(cmd, args, { stdio: "inherit" });
+    if (process.stdin.isTTY && process.stdin.setRawMode) {
+        try {
+            process.stdin.setRawMode(wasRaw);
+        }
+        catch { }
+    }
+    if (result.error || result.status !== 0) {
+        try {
+            fs.unlinkSync(filePath);
+        }
+        catch { }
+        return { ok: false, content: initial, cancelled: false };
+    }
+    let content;
+    try {
+        content = fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return { ok: false, content: initial, cancelled: false };
+    }
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch { }
+    if (content.trim().length === 0) {
+        return { ok: true, content: "", cancelled: true };
+    }
+    return { ok: true, content, cancelled: false };
+}

package/dist/lib/dashboard/types.d.ts

@@ -60,7 +60,7 @@ export interface EnrichedReviewPR {
 export type DashboardTab = "issues" | "reviews";
 export type ActionOverlay = "mode-select" | "context-input" | "base-select" | "confirm-delete" | "confirm-setup" | "commit" | "pr-create" | null;
 export type CommitPhase = "idle" | "confirm-stage" | "awaiting-message" | "committing" | "pushing" | "done" | "error";
-export type PrCreatePhase = "idle" | "choose-mode" | "pushing" | "filling" | "review" | "creating" | "done" | "error";
+export type PrCreatePhase = "idle" | "choose-mode" | "pushing" | "filling" | "review" | "confirm" | "creating" | "done" | "error";
 export interface DashboardState {
     activeTab: DashboardTab;
     groups: ProjectGroup[];
@@ -102,6 +102,7 @@ export interface DashboardState {
     baseSelectChosen: string | null;
     contextInputValue: string;
     contextInputMode: "plan" | "implement" | null;
+    contextInputPhase: "editing" | "review";
 }
 export type DashboardAction = {
     type: "SET_DATA";
@@ -181,6 +182,13 @@ export type DashboardAction = {
     type: "PR_CREATE_REVIEW";
     body: string;
     title: string;
+} | {
+    type: "PR_CREATE_BODY_CHANGE";
+    body: string;
+} | {
+    type: "PR_CREATE_CONFIRM";
+} | {
+    type: "PR_CREATE_EDIT";
 } | {
     type: "PR_CREATE_DONE";
     url: string;
@@ -223,6 +231,10 @@ export type DashboardAction = {
 } | {
     type: "CONTEXT_INPUT_CHANGE";
     value: string;
+} | {
+    type: "CONTEXT_INPUT_REVIEW";
+} | {
+    type: "CONTEXT_INPUT_EDIT";
 } | {
     type: "CONTEXT_INPUT_DONE";
 };

package/dist/lib/dashboard/types.js

@@ -40,6 +40,7 @@ export const initialState = {
     baseSelectChosen: null,
     contextInputValue: "",
     contextInputMode: null,
+    contextInputPhase: "editing",
 };
 export function reducer(state, action) {
     switch (action.type) {
@@ -165,6 +166,12 @@ export function reducer(state, action) {
                 prCreateTitle: action.title,
                 detailScrollOffset: 0,
             };
+        case "PR_CREATE_BODY_CHANGE":
+            return { ...state, prCreateBody: action.body };
+        case "PR_CREATE_CONFIRM":
+            return { ...state, prCreatePhase: "confirm" };
+        case "PR_CREATE_EDIT":
+            return { ...state, prCreatePhase: "review" };
         case "PR_CREATE_DONE":
             return {
                 ...state,
@@ -250,15 +257,21 @@ export function reducer(state, action) {
                 overlay: "context-input",
                 contextInputMode: action.mode,
                 contextInputValue: "",
+                contextInputPhase: "editing",
             };
         case "CONTEXT_INPUT_CHANGE":
             return { ...state, contextInputValue: action.value };
+        case "CONTEXT_INPUT_REVIEW":
+            return { ...state, contextInputPhase: "review" };
+        case "CONTEXT_INPUT_EDIT":
+            return { ...state, contextInputPhase: "editing" };
         case "CONTEXT_INPUT_DONE":
             return {
                 ...state,
                 overlay: null,
                 contextInputMode: null,
                 contextInputValue: "",
+                contextInputPhase: "editing",
             };
         default:
             return state;

package/dist/lib/git.d.ts

@@ -257,11 +257,13 @@ export declare function getDiffContent(baseBranch: string): string | null;
  */
 export declare function readSessionState(repoRoot: string, ticketId: string): SessionState | null;
 /**
- * Check if a claude process is running in a tmux window for the given ticket.
- * Windows are named after ticket IDs (possibly with suffixes like " !" or " ~").
- * Gets the pane PID and walks the process tree looking for a "claude" process.
+ * Check if a session for the given ticket is still alive in the active multiplexer.
+ * Delegates to the configured multiplexer (tmux: pane_pid + pgrep claude;
+ * cmux: workspace lookup; none: always false). Callers should also consult the
+ * .santree/session-states/<ticketId>.json file — that's the authoritative signal
+ * written by Claude Code hooks, while this is the "is the terminal still up" backstop.
  */
-export declare function isSessionAliveInTmux(ticketId: string): boolean;
+export declare function isSessionAlive(ticketId: string): boolean;
 /**
  * Delete the session state file for a given ticket.
  */

package/dist/lib/git.js

@@ -3,6 +3,7 @@ import { promisify } from "util";
 import * as path from "path";
 import * as fs from "fs";
 import { run, runAsync } from "./exec.js";
+import { getMultiplexer } from "./multiplexer/index.js";
 const execAsync = promisify(exec);
 /**
  * Find the toplevel directory of the current git repository.
@@ -610,40 +611,14 @@ export function readSessionState(repoRoot, ticketId) {
     }
 }
 /**
- * Check if a claude process is running in a tmux window for the given ticket.
- * Windows are named after ticket IDs (possibly with suffixes like " !" or " ~").
- * Gets the pane PID and walks the process tree looking for a "claude" process.
+ * Check if a session for the given ticket is still alive in the active multiplexer.
+ * Delegates to the configured multiplexer (tmux: pane_pid + pgrep claude;
+ * cmux: workspace lookup; none: always false). Callers should also consult the
+ * .santree/session-states/<ticketId>.json file — that's the authoritative signal
+ * written by Claude Code hooks, while this is the "is the terminal still up" backstop.
  */
-export function isSessionAliveInTmux(ticketId) {
-    try {
-        const output = execSync('tmux list-windows -F "#{window_name}\t#{pane_pid}"', {
-            encoding: "utf-8",
-            stdio: ["pipe", "pipe", "ignore"],
-        }).trim();
-        for (const line of output.split("\n")) {
-            const [name, pidStr] = line.split("\t");
-            if (!name?.startsWith(ticketId))
-                continue;
-            if (!pidStr)
-                return false;
-            // Check if any descendant of the shell PID is a claude process
-            try {
-                const ps = execSync(`pgrep -P ${pidStr} -a`, {
-                    encoding: "utf-8",
-                    stdio: ["pipe", "pipe", "ignore"],
-                }).trim();
-                return ps.split("\n").some((proc) => proc.includes("claude"));
-            }
-            catch {
-                // pgrep exits 1 when no matches — shell has no children
-                return false;
-            }
-        }
-    }
-    catch {
-        // tmux not available or not in a tmux session
-    }
-    return false;
+export function isSessionAlive(ticketId) {
+    return getMultiplexer().isSessionAlive(ticketId);
 }
 /**
  * Delete the session state file for a given ticket.

package/dist/lib/multiplexer/cmux.d.ts

@@ -0,0 +1,2 @@
+import type { Multiplexer } from "./types.js";
+export declare const cmuxMultiplexer: Multiplexer;

package/dist/lib/multiplexer/cmux.js

@@ -0,0 +1,97 @@
+import { execSync } from "child_process";
+import { shellEscape } from "./types.js";
+const CMUX_TIMEOUT_MS = 2000;
+function cmuxRun(cmd) {
+    try {
+        const stdout = execSync(cmd, {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "ignore"],
+            timeout: CMUX_TIMEOUT_MS,
+        });
+        return { ok: true, stdout };
+    }
+    catch {
+        return { ok: false };
+    }
+}
+function findWorkspaceByTitle(title) {
+    // `--json` is a global flag and must precede the subcommand.
+    const result = cmuxRun("cmux --json list-workspaces");
+    if (!result.ok)
+        return null;
+    try {
+        const parsed = JSON.parse(result.stdout);
+        const items = parsed.workspaces ?? [];
+        return items.find((w) => w.title === title) ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export const cmuxMultiplexer = {
+    kind: "cmux",
+    isActive() {
+        return !!process.env["CMUX_SURFACE_ID"];
+    },
+    async createWindow({ name, cwd, command }) {
+        // `new-workspace` accepts --name, --cwd, --command in a single atomic call.
+        // `--command` sends "<text>\n" to the new surface after creation. cmux #1472 means
+        // programmatically created workspaces have dead PTYs, so the command may not actually
+        // execute — but the workspace + name are created, which is the visible win.
+        const parts = [`cmux new-workspace --name ${shellEscape(name)} --cwd ${shellEscape(cwd)}`];
+        if (command)
+            parts.push(`--command ${shellEscape(command)}`);
+        const created = cmuxRun(parts.join(" "));
+        if (!created.ok) {
+            return { ok: false, reason: "failed", message: "cmux new-workspace failed" };
+        }
+        return { ok: true };
+    },
+    async selectWindow(name) {
+        const ws = findWorkspaceByTitle(name);
+        if (!ws?.ref) {
+            return { ok: false, reason: "failed", message: `no cmux workspace named ${name}` };
+        }
+        const result = cmuxRun(`cmux select-workspace --workspace ${shellEscape(ws.ref)}`);
+        return result.ok ? { ok: true } : { ok: false, reason: "failed" };
+    },
+    renameWindow(currentName, newName) {
+        // `workspace-action --action rename --title <text>` defaults to the caller's
+        // workspace via $CMUX_WORKSPACE_ID. When `currentName` is provided we look up
+        // that specific workspace's ref instead.
+        let target = "";
+        if (currentName) {
+            const ws = findWorkspaceByTitle(currentName);
+            if (!ws?.ref) {
+                return { ok: false, reason: "failed", message: "cmux workspace not found" };
+            }
+            target = ` --workspace ${shellEscape(ws.ref)}`;
+        }
+        const result = cmuxRun(`cmux workspace-action --action rename --title ${shellEscape(newName)}${target}`);
+        return result.ok ? { ok: true } : { ok: false, reason: "failed" };
+    },
+    sendCommand(_name, _command) {
+        // Blocked by manaflow-ai/cmux#1472 — programmatically created workspaces have
+        // dead PTYs, so post-creation `cmux send` / `send-key` silently drop input.
+        // Initial command-on-create works via `new-workspace --command`; this path is for
+        // follow-up sends to an existing workspace, which doesn't.
+        return {
+            ok: false,
+            reason: "unsupported",
+            message: "blocked by manaflow-ai/cmux#1472",
+        };
+    },
+    isSessionAlive(ticketId) {
+        const result = cmuxRun("cmux --json list-workspaces");
+        if (!result.ok)
+            return false;
+        try {
+            const parsed = JSON.parse(result.stdout);
+            const items = parsed.workspaces ?? [];
+            return items.some((w) => typeof w.title === "string" && w.title.startsWith(ticketId));
+        }
+        catch {
+            return false;
+        }
+    },
+};

package/dist/lib/multiplexer/index.d.ts

@@ -0,0 +1,4 @@
+import type { Multiplexer, MultiplexerKind } from "./types.js";
+export type { CreateWindowOpts, Multiplexer, MultiplexerKind, SessionResult } from "./types.js";
+export declare function getMultiplexer(): Multiplexer;
+export declare function getMultiplexerKind(): MultiplexerKind;

package/dist/lib/multiplexer/index.js

@@ -0,0 +1,20 @@
+import { cmuxMultiplexer } from "./cmux.js";
+import { noneMultiplexer } from "./none.js";
+import { tmuxMultiplexer } from "./tmux.js";
+export function getMultiplexer() {
+    const explicit = process.env["SANTREE_MULTIPLEXER"]?.toLowerCase();
+    if (explicit === "tmux")
+        return tmuxMultiplexer;
+    if (explicit === "cmux")
+        return cmuxMultiplexer;
+    if (explicit === "none")
+        return noneMultiplexer;
+    if (process.env["TMUX"])
+        return tmuxMultiplexer;
+    if (process.env["CMUX_SURFACE_ID"])
+        return cmuxMultiplexer;
+    return noneMultiplexer;
+}
+export function getMultiplexerKind() {
+    return getMultiplexer().kind;
+}

package/dist/lib/multiplexer/none.d.ts

@@ -0,0 +1,2 @@
+import type { Multiplexer } from "./types.js";
+export declare const noneMultiplexer: Multiplexer;

package/dist/lib/multiplexer/none.js

@@ -0,0 +1,22 @@
+const NOT_ACTIVE = { ok: false, reason: "not-active" };
+export const noneMultiplexer = {
+    kind: "none",
+    isActive() {
+        return false;
+    },
+    async createWindow() {
+        return NOT_ACTIVE;
+    },
+    async selectWindow() {
+        return NOT_ACTIVE;
+    },
+    renameWindow() {
+        return NOT_ACTIVE;
+    },
+    sendCommand() {
+        return NOT_ACTIVE;
+    },
+    isSessionAlive() {
+        return false;
+    },
+};

package/dist/lib/multiplexer/tmux.d.ts

@@ -0,0 +1,2 @@
+import type { Multiplexer } from "./types.js";
+export declare const tmuxMultiplexer: Multiplexer;

package/dist/lib/multiplexer/tmux.js

@@ -0,0 +1,82 @@
+import { execSync } from "child_process";
+import { shellEscape } from "./types.js";
+function tmuxSync(cmd) {
+    try {
+        execSync(cmd, { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export const tmuxMultiplexer = {
+    kind: "tmux",
+    isActive() {
+        return !!process.env["TMUX"];
+    },
+    async createWindow({ name, cwd, command }) {
+        if (!this.isActive())
+            return { ok: false, reason: "not-active" };
+        const ok = tmuxSync(`tmux new-window -n ${shellEscape(name)} -c ${shellEscape(cwd)}`);
+        if (!ok)
+            return { ok: false, reason: "failed", message: "tmux new-window failed" };
+        if (command) {
+            // Brief race guard: tmux occasionally drops send-keys if it arrives before the
+            // window's shell is up. The dashboard has used this for years.
+            await new Promise((r) => setTimeout(r, 100));
+            const sent = tmuxSync(`tmux send-keys -t ${shellEscape(name)} ${shellEscape(command)} Enter`);
+            if (!sent)
+                return { ok: false, reason: "failed", message: "tmux send-keys failed" };
+        }
+        return { ok: true };
+    },
+    async selectWindow(name) {
+        if (!this.isActive())
+            return { ok: false, reason: "not-active" };
+        const ok = tmuxSync(`tmux select-window -t ${shellEscape(name)}`);
+        return ok ? { ok: true } : { ok: false, reason: "failed" };
+    },
+    renameWindow(_currentName, newName) {
+        if (!this.isActive())
+            return { ok: false, reason: "not-active" };
+        // tmux rename-window operates on the current window when no -t is given, which
+        // matches every existing call site in santree.
+        const ok = tmuxSync(`tmux rename-window ${shellEscape(newName)}`);
+        return ok ? { ok: true } : { ok: false, reason: "failed" };
+    },
+    sendCommand(name, command) {
+        if (!this.isActive())
+            return { ok: false, reason: "not-active" };
+        const ok = tmuxSync(`tmux send-keys -t ${shellEscape(name)} ${shellEscape(command)} Enter`);
+        return ok ? { ok: true } : { ok: false, reason: "failed" };
+    },
+    isSessionAlive(ticketId) {
+        try {
+            const output = execSync('tmux list-windows -F "#{window_name}\t#{pane_pid}"', {
+                encoding: "utf-8",
+                stdio: ["pipe", "pipe", "ignore"],
+            }).trim();
+            for (const line of output.split("\n")) {
+                const [name, pidStr] = line.split("\t");
+                if (!name?.startsWith(ticketId))
+                    continue;
+                if (!pidStr)
+                    return false;
+                try {
+                    const ps = execSync(`pgrep -P ${pidStr} -a`, {
+                        encoding: "utf-8",
+                        stdio: ["pipe", "pipe", "ignore"],
+                    }).trim();
+                    return ps.split("\n").some((proc) => proc.includes("claude"));
+                }
+                catch {
+                    return false;
+                }
+            }
+        }
+        catch {
+            // tmux not available
+        }
+        return false;
+    },
+};

package/dist/lib/multiplexer/types.d.ts

@@ -0,0 +1,23 @@
+export type MultiplexerKind = "tmux" | "cmux" | "none";
+export type SessionResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: "not-active" | "unsupported" | "failed";
+    message?: string;
+};
+export interface CreateWindowOpts {
+    name: string;
+    cwd: string;
+    command?: string;
+}
+export interface Multiplexer {
+    readonly kind: MultiplexerKind;
+    isActive(): boolean;
+    createWindow(opts: CreateWindowOpts): Promise<SessionResult>;
+    selectWindow(name: string): Promise<SessionResult>;
+    renameWindow(currentName: string, newName: string): SessionResult;
+    sendCommand(name: string, command: string): SessionResult;
+    isSessionAlive(ticketId: string): boolean;
+}
+export declare function shellEscape(s: string): string;

package/dist/lib/multiplexer/types.js

@@ -0,0 +1,3 @@
+export function shellEscape(s) {
+    return `'${s.replace(/'/g, `'\\''`)}'`;
+}

package/dist/lib/session-signal.js

@@ -1,6 +1,7 @@
 import * as fs from "fs";
 import * as path from "path";
-import { execSync, spawn } from "child_process";
+import { spawn } from "child_process";
+import { getMultiplexer } from "./multiplexer/index.js";
 export function readStdin() {
     try {
         return fs.readFileSync(0, "utf-8");
@@ -22,7 +23,8 @@ export function extractRepoAndTicket(cwd) {
     return { repoRoot, ticketId };
 }
 export function renameTmuxWindow(ticketId, state) {
-    if (!process.env.TMUX)
+    const mux = getMultiplexer();
+    if (!mux.isActive())
         return;
     let name;
     switch (state) {
@@ -36,12 +38,7 @@ export function renameTmuxWindow(ticketId, state) {
             name = ticketId;
             break;
     }
-    try {
-        execSync(`tmux rename-window "${name}"`, { stdio: "ignore" });
-    }
-    catch {
-        // Ignore tmux errors
-    }
+    mux.renameWindow("", name);
 }
 export function runHookScript(repoRoot, state, env) {
     const script = path.join(repoRoot, ".santree", "hooks", `on-${state}.sh`);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "santree",
-	"version": "0.2.15",
+	"version": "0.4.0",
 	"description": "Git worktree manager",
 	"license": "MIT",
 	"author": "Santiago Toscanini",