santree 0.2.13 → 0.2.15

package/dist/commands/dashboard.js

@@ -24,6 +24,7 @@ import DetailPanel from "../lib/dashboard/DetailPanel.js";
 import ReviewList from "../lib/dashboard/ReviewList.js";
 import ReviewDetailPanel from "../lib/dashboard/ReviewDetailPanel.js";
 import { CommitOverlay, PrCreateOverlay } from "../lib/dashboard/Overlays.js";
+import { MultilineTextArea } from "../lib/dashboard/MultilineTextArea.js";
 export const description = "Interactive dashboard of your Linear issues";
 const execAsync = promisify(exec);
 const CLAUDE_VERSION = (() => {
@@ -367,13 +368,27 @@ export default function Dashboard() {
             dispatch({ type: "REVIEW_SCROLL_LIST", offset });
         }
     }, [state.reviewSelectedIndex, state.flatReviews, contentHeight, state.reviewListScrollOffset]);
+    // ── 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.
+    useEffect(() => {
+        if (state.overlay !== "context-input")
+            return;
+        process.stdout.write("\x1b[?1002l\x1b[?1006l");
+        return () => {
+            process.stdout.write("\x1b[?1002h\x1b[?1006h");
+        };
+    }, [state.overlay]);
     // ── Actions ───────────────────────────────────────────────────────
-    const launchWorkInTmux = useCallback((di, mode, worktreePath) => {
+    const launchWorkInTmux = useCallback((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 workCmd = mode === "plan" ? "st worktree work --plan" : "st worktree work";
+        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" });
@@ -409,10 +424,13 @@ export default function Dashboard() {
         // Delayed refresh to pick up session ID created by `st worktree work`
         setTimeout(() => refresh(), 3000);
     }, [refresh]);
-    const launchAfterCreation = useCallback((mode, worktreePath, ticketId) => {
+    const launchAfterCreation = useCallback((mode, worktreePath, ticketId, contextFile) => {
         if (isInTmux()) {
             const windowName = ticketId;
-            const workCmd = mode === "plan" ? "st worktree work --plan" : "st worktree work";
+            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" });
@@ -431,10 +449,25 @@ export default function Dashboard() {
             leaveAltScreen();
             console.log(`SANTREE_CD:${worktreePath}`);
             console.log(`SANTREE_WORK:${mode}`);
+            if (contextFile)
+                console.log(`SANTREE_WORK_CONTEXT:${contextFile}`);
             exit();
         }
     }, [exit, refresh]);
-    const createAndLaunch = useCallback(async (mode, runSetup, base) => {
+    const writeContextFile = useCallback((context) => {
+        const trimmed = context?.trim();
+        if (!trimmed)
+            return undefined;
+        const filePath = path.join(os.tmpdir(), `santree-context-${Date.now()}.md`);
+        try {
+            fs.writeFileSync(filePath, trimmed);
+            return filePath;
+        }
+        catch {
+            return undefined;
+        }
+    }, []);
+    const createAndLaunch = useCallback(async (mode, runSetup, base, contextFile) => {
         const di = stateRef.current.flatIssues[stateRef.current.selectedIndex];
         if (!di)
             return;
@@ -527,8 +560,10 @@ export default function Dashboard() {
         }
         // 4. Done — launch work
         dispatch({ type: "CREATION_DONE" });
-        launchAfterCreation(mode, result.path, ticketId);
+        launchAfterCreation(mode, result.path, ticketId, contextFile);
     }, [launchAfterCreation]);
+    // Holds the context file path through multi-step flows (mode-select → base-select → confirm-setup → create)
+    const pendingContextFileRef = useRef(null);
     const proceedAfterBaseSelect = useCallback((mode, base) => {
         const repoRoot = repoRootRef.current;
         if (!repoRoot)
@@ -537,9 +572,11 @@ export default function Dashboard() {
             dispatch({ type: "SETUP_CONFIRM_SHOW", mode });
             return;
         }
-        createAndLaunch(mode, false, base);
+        const contextFile = pendingContextFileRef.current ?? undefined;
+        pendingContextFileRef.current = null;
+        createAndLaunch(mode, false, base, contextFile);
     }, [createAndLaunch]);
-    const doWork = useCallback((mode) => {
+    const doWork = useCallback((mode, customContext) => {
         const di = state.flatIssues[state.selectedIndex];
         if (!di)
             return;
@@ -547,20 +584,24 @@ export default function Dashboard() {
         if (!repoRoot)
             return;
         dispatch({ type: "SET_OVERLAY", overlay: null });
+        const contextFile = writeContextFile(customContext);
         if (di.worktree) {
             // Worktree exists — launch work
             if (isInTmux()) {
-                launchWorkInTmux(di, mode, di.worktree.path);
+                launchWorkInTmux(di, mode, di.worktree.path, contextFile);
             }
             else {
                 leaveAltScreen();
                 console.log(`SANTREE_CD:${di.worktree.path}`);
                 console.log(`SANTREE_WORK:${mode}`);
+                if (contextFile)
+                    console.log(`SANTREE_WORK_CONTEXT:${contextFile}`);
                 exit();
             }
         }
         else {
-            // No worktree — collect possible base branches
+            // No worktree — stash context for the create flow to pick up
+            pendingContextFileRef.current = contextFile ?? null;
             const defaultBranch = getDefaultBranch();
             const baseOptions = [defaultBranch];
             for (const fi of state.flatIssues) {
@@ -578,7 +619,14 @@ export default function Dashboard() {
             // Only default branch available — skip base select
             proceedAfterBaseSelect(mode);
         }
-    }, [state.flatIssues, state.selectedIndex, exit, launchWorkInTmux, proceedAfterBaseSelect]);
+    }, [
+        state.flatIssues,
+        state.selectedIndex,
+        exit,
+        launchWorkInTmux,
+        proceedAfterBaseSelect,
+        writeContextFile,
+    ]);
     // ── Commit flow ──────────────────────────────────────────────────
     const handleStageAll = useCallback(async () => {
         const wtPath = stateRef.current.commitWorktreePath;
@@ -918,16 +966,21 @@ export default function Dashboard() {
             const base = state.baseSelectChosen ?? undefined;
             if (input === "y" && mode) {
                 dispatch({ type: "SETUP_CONFIRM_DONE" });
-                createAndLaunch(mode, true, base);
+                const contextFile = pendingContextFileRef.current ?? undefined;
+                pendingContextFileRef.current = null;
+                createAndLaunch(mode, true, base, contextFile);
                 return;
             }
             if (input === "n" && mode) {
                 dispatch({ type: "SETUP_CONFIRM_DONE" });
-                createAndLaunch(mode, false, base);
+                const contextFile = pendingContextFileRef.current ?? undefined;
+                pendingContextFileRef.current = null;
+                createAndLaunch(mode, false, base, contextFile);
                 return;
             }
             if (key.escape) {
                 dispatch({ type: "SETUP_CONFIRM_DONE" });
+                pendingContextFileRef.current = null;
                 return;
             }
             return;
@@ -935,11 +988,11 @@ export default function Dashboard() {
         // Mode select overlay
         if (state.overlay === "mode-select") {
             if (input === "p" || input === "1") {
-                doWork("plan");
+                dispatch({ type: "CONTEXT_INPUT_SHOW", mode: "plan" });
                 return;
             }
             if (input === "i" || input === "2") {
-                doWork("implement");
+                dispatch({ type: "CONTEXT_INPUT_SHOW", mode: "implement" });
                 return;
             }
             if (key.escape || input === "q") {
@@ -948,6 +1001,11 @@ export default function Dashboard() {
             }
             return;
         }
+        // Context-input overlay — MultilineTextArea owns its own useInput;
+        // outer useInput is disabled for this overlay via isActive below.
+        if (state.overlay === "context-input") {
+            return;
+        }
         // Confirm delete overlay
         if (state.overlay === "confirm-delete") {
             if (input === "y") {
@@ -1416,7 +1474,10 @@ export default function Dashboard() {
             dispatch({ type: "SET_OVERLAY", overlay: "confirm-delete" });
             return;
         }
-    }, { isActive: state.overlay !== "commit" || state.commitPhase !== "awaiting-message" });
+    }, {
+        isActive: state.overlay !== "context-input" &&
+            (state.overlay !== "commit" || state.commitPhase !== "awaiting-message"),
+    });
     // ── Render ─────────────────────────────────────────────────────────
     if (state.loading) {
         return (_jsx(Box, { width: columns, height: rows, flexDirection: "column", children: _jsxs(Box, { justifyContent: "center", alignItems: "center", flexGrow: 1, children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Loading dashboard..." })] }) }));
@@ -1426,7 +1487,13 @@ 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 === "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, 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) => {
                             const selected = idx === state.baseSelectIndex;
                             const defaultBranch = getDefaultBranch();
                             const label = branch === defaultBranch ? `${branch} (default)` : branch;

package/dist/commands/helpers/statusline.js

@@ -132,6 +132,16 @@ function getGitChanges(cwd) {
         untracked: countLines(git(cwd, "ls-files --others --exclude-standard")),
     };
 }
+// Build a progress bar for context usage
+function formatContextUsage(usedPercentage) {
+    const used = Math.round(usedPercentage);
+    const color = used >= 80 ? c.red : used >= 60 ? c.yellow : c.green;
+    const width = 20;
+    const filled = Math.round((used * width) / 100);
+    const empty = width - filled;
+    const bar = "▓".repeat(filled) + "░".repeat(empty);
+    return `${color}[${bar}] ${used}%${c.reset}`;
+}
 // Format changes compactly
 function formatChanges(changes) {
     const parts = [];
@@ -177,9 +187,7 @@ function buildSantreeStatusline(cwd, model, usedPercentage) {
     }
     // Context usage %
     if (usedPercentage !== null) {
-        const used = Math.round(usedPercentage);
-        const color = used >= 80 ? c.red : used >= 60 ? c.yellow : c.green;
-        parts.push(`${color}${used}%${c.reset}`);
+        parts.push(formatContextUsage(usedPercentage));
     }
     return parts.join(" | ");
 }
@@ -202,9 +210,7 @@ function buildGitStatusline(cwd, model, usedPercentage) {
     }
     // Context usage %
     if (usedPercentage !== null) {
-        const used = Math.round(usedPercentage);
-        const color = used >= 80 ? c.red : used >= 60 ? c.yellow : c.green;
-        parts.push(`${color}${used}%${c.reset}`);
+        parts.push(formatContextUsage(usedPercentage));
     }
     return parts.join(" | ");
 }
@@ -220,9 +226,7 @@ function buildPlainStatusline(cwd, model, usedPercentage) {
     }
     // Context usage %
     if (usedPercentage !== null) {
-        const used = Math.round(usedPercentage);
-        const color = used >= 80 ? c.red : used >= 60 ? c.yellow : c.green;
-        parts.push(`${color}${used}%${c.reset}`);
+        parts.push(formatContextUsage(usedPercentage));
     }
     return parts.join(" | ");
 }

package/dist/commands/worktree/work.d.ts

@@ -2,6 +2,7 @@ import { z } from "zod";
 export declare const description = "Launch Claude to work on current ticket";
 export declare const options: z.ZodObject<{
     plan: z.ZodOptional<z.ZodBoolean>;
+    contextFile: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type Props = {
     options: z.infer<typeof options>;

package/dist/commands/worktree/work.js

@@ -3,12 +3,17 @@ import { useEffect, useState } from "react";
 import { Text, Box } from "ink";
 import Spinner from "ink-spinner";
 import { z } from "zod";
+import { readFileSync, unlinkSync } from "fs";
 import { resolveAIContext, renderAIPrompt, launchAgent, cleanupImages, } from "../../lib/ai.js";
 import { randomUUID } from "crypto";
 import { getSessionId, setSessionId } from "../../lib/git.js";
 export const description = "Launch Claude to work on current ticket";
 export const options = z.object({
     plan: z.boolean().optional().describe("Only create implementation plan"),
+    contextFile: z
+        .string()
+        .optional()
+        .describe("Path to a file whose contents are appended to the prompt as extra context"),
 });
 function getModeLabel(mode) {
     return mode === "plan" ? "plan only" : "implement";
@@ -23,6 +28,7 @@ export default function Work({ options }) {
     const [error, setError] = useState(null);
     const [mode] = useState(options.plan ? "plan" : "implement");
     const [aiContext, setAiContext] = useState(null);
+    const contextFilePath = options.contextFile;
     useEffect(() => {
         async function init() {
             // Small delay to allow spinner to render
@@ -46,7 +52,22 @@ export default function Work({ options }) {
         if (status !== "ready" || !aiContext)
             return;
         setStatus("launching");
-        const prompt = renderAIPrompt("work", aiContext, { mode });
+        let customContext;
+        if (contextFilePath) {
+            try {
+                customContext = readFileSync(contextFilePath, "utf-8").trim() || undefined;
+            }
+            catch {
+                // File missing or unreadable — proceed without extra context
+            }
+            try {
+                unlinkSync(contextFilePath);
+            }
+            catch {
+                // Cleanup failure is non-fatal
+            }
+        }
+        const prompt = renderAIPrompt("work", aiContext, { mode, custom_context: customContext });
         // Get or create a session ID for this ticket
         let sessionId;
         let isResume = false;

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

@@ -0,0 +1,12 @@
+interface MultilineTextAreaProps {
+    value: string;
+    onChange: (value: string) => void;
+    onSubmit: () => void;
+    onCancel: () => void;
+    placeholder?: string;
+    width?: number;
+    height?: number;
+    focus?: boolean;
+}
+export declare function MultilineTextArea({ value, onChange, onSubmit, onCancel, placeholder, width, height, focus, }: MultilineTextAreaProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/lib/dashboard/MultilineTextArea.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text, useInput } from "ink";
+export function MultilineTextArea({ value, onChange, onSubmit, onCancel, placeholder, width, height = 6, focus = true, }) {
+    useInput((input, key) => {
+        // Ctrl+D submits
+        if (key.ctrl && input === "d") {
+            onSubmit();
+            return;
+        }
+        // ESC cancels. Parent disables SGR mouse tracking while this overlay is
+        // mounted so clicks can no longer masquerade as ESC.
+        if (key.escape) {
+            onCancel();
+            return;
+        }
+        if (key.backspace || key.delete) {
+            onChange(value.slice(0, -1));
+            return;
+        }
+        // Swallow navigation keys — this is an append-only text area.
+        if (key.upArrow || key.downArrow || key.leftArrow || key.rightArrow || key.tab)
+            return;
+        // Enter inserts a newline. MUST run before the meta/ctrl swallow below so
+        // Option+Enter and Ctrl+Enter also insert newlines. When Ink delivers a
+        // paste as one chunk, `input` may carry embedded content alongside the
+        // \r — normalize and append the whole thing instead of dropping it.
+        if (key.return) {
+            const chunk = input ? input.replace(/\r\n?/g, "\n") : "\n";
+            onChange(value + chunk);
+            return;
+        }
+        // Swallow remaining modifier combos.
+        if (key.ctrl || key.meta)
+            return;
+        if (!input)
+            return;
+        // Pasted content may embed \r or \r\n — normalize to \n.
+        const normalized = input.replace(/\r\n?/g, "\n");
+        onChange(value + normalized);
+    }, { isActive: focus });
+    const lines = value.length === 0 ? [""] : value.split("\n");
+    const visibleLines = lines.slice(Math.max(0, lines.length - height));
+    const isEmpty = value.length === 0;
+    return (_jsx(Box, { flexDirection: "column", width: width, borderStyle: "round", borderColor: "cyan", paddingX: 1, minHeight: height + 2, children: isEmpty && placeholder ? (_jsxs(Box, { minHeight: 1, children: [_jsx(Text, { color: "cyan", children: "\u2588" }), _jsx(Text, { dimColor: true, children: placeholder })] })) : (visibleLines.map((line, i) => {
+            const isLast = i === visibleLines.length - 1;
+            return (_jsxs(Box, { minHeight: 1, children: [_jsx(Text, { children: line }), isLast && focus ? _jsx(Text, { color: "cyan", children: "\u2588" }) : null] }, i));
+        })) }));
+}

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

@@ -58,7 +58,7 @@ export interface EnrichedReviewPR {
     worktree: WorktreeInfo | null;
 }
 export type DashboardTab = "issues" | "reviews";
-export type ActionOverlay = "mode-select" | "base-select" | "confirm-delete" | "confirm-setup" | "commit" | "pr-create" | null;
+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 interface DashboardState {
@@ -100,6 +100,8 @@ export interface DashboardState {
     baseSelectOptions: string[];
     baseSelectIndex: number;
     baseSelectChosen: string | null;
+    contextInputValue: string;
+    contextInputMode: "plan" | "implement" | null;
 }
 export type DashboardAction = {
     type: "SET_DATA";
@@ -215,6 +217,14 @@ export type DashboardAction = {
 } | {
     type: "REVIEW_SCROLL_DETAIL";
     offset: number;
+} | {
+    type: "CONTEXT_INPUT_SHOW";
+    mode: "plan" | "implement";
+} | {
+    type: "CONTEXT_INPUT_CHANGE";
+    value: string;
+} | {
+    type: "CONTEXT_INPUT_DONE";
 };
 export declare const initialState: DashboardState;
 export declare function reducer(state: DashboardState, action: DashboardAction): DashboardState;

package/dist/lib/dashboard/types.js

@@ -38,6 +38,8 @@ export const initialState = {
     baseSelectOptions: [],
     baseSelectIndex: 0,
     baseSelectChosen: null,
+    contextInputValue: "",
+    contextInputMode: null,
 };
 export function reducer(state, action) {
     switch (action.type) {
@@ -242,6 +244,22 @@ export function reducer(state, action) {
             return { ...state, reviewListScrollOffset: action.offset };
         case "REVIEW_SCROLL_DETAIL":
             return { ...state, reviewDetailScrollOffset: action.offset };
+        case "CONTEXT_INPUT_SHOW":
+            return {
+                ...state,
+                overlay: "context-input",
+                contextInputMode: action.mode,
+                contextInputValue: "",
+            };
+        case "CONTEXT_INPUT_CHANGE":
+            return { ...state, contextInputValue: action.value };
+        case "CONTEXT_INPUT_DONE":
+            return {
+                ...state,
+                overlay: null,
+                contextInputMode: null,
+                contextInputValue: "",
+            };
         default:
             return state;
     }

package/package.json

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

package/prompts/work.njk

@@ -6,6 +6,12 @@ If a Linear MCP server is available, use it to fetch the ticket description, com
 Otherwise, proceed based on branch name context.
 {% endif %}
 
+{% if custom_context %}
+## Additional context from the user
+
+{{ custom_context }}
+
+{% endif %}
 Review the codebase to understand the relevant areas and existing patterns.
 {% if mode == "plan" %}
 Create a detailed implementation plan with:

package/shell/init.bash.njk

@@ -51,7 +51,7 @@ function santree() {
         local exit_code=$?
 
         if [[ "$output" == *SANTREE_CD:* ]]; then
-            echo "$output" | grep -v "SANTREE_CD:" | grep -v "SANTREE_WORK:"
+            echo "$output" | grep -v "SANTREE_CD:" | grep -v "SANTREE_WORK:" | grep -v "SANTREE_WORK_CONTEXT:"
 
             local target_dir=$(echo "$output" | sed 's/\x1b\[[0-9;]*m//g' | grep "SANTREE_CD:" | sed 's/.*SANTREE_CD://')
 
@@ -60,8 +60,16 @@ function santree() {
             fi
 
             if [[ "$output" == *SANTREE_WORK:* ]]; then
-                local work_mode=$(echo "$output" | sed 's/\x1b\[[0-9;]*m//g' | grep "SANTREE_WORK:" | sed 's/.*SANTREE_WORK://')
-                [[ "$work_mode" == "plan" ]] && command santree worktree work --plan || command santree worktree work
+                local work_mode=$(echo "$output" | sed 's/\x1b\[[0-9;]*m//g' | grep "^SANTREE_WORK:" | sed 's/.*SANTREE_WORK://')
+                local context_file=""
+                if [[ "$output" == *SANTREE_WORK_CONTEXT:* ]]; then
+                    context_file=$(echo "$output" | sed 's/\x1b\[[0-9;]*m//g' | grep "SANTREE_WORK_CONTEXT:" | sed 's/.*SANTREE_WORK_CONTEXT://')
+                fi
+                if [[ -n "$context_file" ]]; then
+                    [[ "$work_mode" == "plan" ]] && command santree worktree work --plan --context-file "$context_file" || command santree worktree work --context-file "$context_file"
+                else
+                    [[ "$work_mode" == "plan" ]] && command santree worktree work --plan || command santree worktree work
+                fi
             fi
         else
             echo "$output"

package/shell/init.zsh.njk

@@ -51,7 +51,7 @@ function santree() {
         local exit_code=$?
 
         if [[ "$output" == *SANTREE_CD:* ]]; then
-            echo "$output" | grep -v "SANTREE_CD:" | grep -v "SANTREE_WORK:"
+            echo "$output" | grep -v "SANTREE_CD:" | grep -v "SANTREE_WORK:" | grep -v "SANTREE_WORK_CONTEXT:"
 
             local target_dir=$(echo "$output" | sed 's/\x1b\[[0-9;]*m//g' | grep "SANTREE_CD:" | sed 's/.*SANTREE_CD://')
 
@@ -60,8 +60,16 @@ function santree() {
             fi
 
             if [[ "$output" == *SANTREE_WORK:* ]]; then
-                local work_mode=$(echo "$output" | sed 's/\x1b\[[0-9;]*m//g' | grep "SANTREE_WORK:" | sed 's/.*SANTREE_WORK://')
-                [[ "$work_mode" == "plan" ]] && command santree worktree work --plan || command santree worktree work
+                local work_mode=$(echo "$output" | sed 's/\x1b\[[0-9;]*m//g' | grep "^SANTREE_WORK:" | sed 's/.*SANTREE_WORK://')
+                local context_file=""
+                if [[ "$output" == *SANTREE_WORK_CONTEXT:* ]]; then
+                    context_file=$(echo "$output" | sed 's/\x1b\[[0-9;]*m//g' | grep "SANTREE_WORK_CONTEXT:" | sed 's/.*SANTREE_WORK_CONTEXT://')
+                fi
+                if [[ -n "$context_file" ]]; then
+                    [[ "$work_mode" == "plan" ]] && command santree worktree work --plan --context-file "$context_file" || command santree worktree work --context-file "$context_file"
+                else
+                    [[ "$work_mode" == "plan" ]] && command santree worktree work --plan || command santree worktree work
+                fi
             fi
         else
             echo "$output"