mintree 0.4.9 → 0.5.0

package/README.md

@@ -126,6 +126,41 @@ chmod 600 ~/.mintree/credentials.json
 
 The key goes straight into the `Authorization` header (no `Bearer` prefix). `mintree doctor` validates the key, resolves the viewer, and pings each configured team when `provider === "linear"`.
 
+### Launch behaviour (optional)
+
+Three top-level keys in `.mintree/metadata.json` tune how mintree launches Claude — all apply to GitHub and Linear repos alike:
+
+```json
+{
+  "version": 1,
+  "provider": "linear",
+  "issues": {},
+  "defaultPermissionMode": "auto",
+  "promptTemplate": "Trabajá en el ticket {{id}} ({{title}}). Abrí {{url}} para el contexto completo y seguí las convenciones del repo.",
+  "orchestratorPromptTemplate": "Hacé de orquestador con los tickets {{ids}} ({{count}} en total). Resolvelos con la menor intervención posible, paralelizando con subagentes salvo dependencias.",
+  "linear": { "workspaceSlug": "my-team", "teams": [{ "key": "FE" }] }
+}
+```
+
+- **`defaultPermissionMode`** (`"default"` | `"auto"`): the Claude `--permission-mode` mintree uses when it launches a session — from the dashboard (`w` / `↵`), `worktree work`, or `worktree create --work`. Omitted (or `"default"`) keeps the stricter default mode; `"auto"` starts every session with auto-accept on. The `--permission-mode` / `-m` CLI flag still overrides it per launch.
+- **`promptTemplate`**: the initial message seeded into the dashboard's `w` overlay (the text Claude receives as its first prompt). It replaces mintree's built-in default and supports these placeholders, substituted per issue:
+
+  | Placeholder | Replaced with                                         |
+  |-------------|-------------------------------------------------------|
+  | `{{id}}`    | Issue id — `100` (GitHub) or `FE-123` (Linear)        |
+  | `{{title}}` | Issue title                                           |
+  | `{{url}}`   | Issue URL (GitHub issue page / Linear issue link)     |
+
+  It's a single line on purpose — the overlay's prompt field is one line, and you can still edit it before launching. When omitted, mintree falls back to its provider-aware default (`gh issue view` for GitHub, the bare id + URL for Linear).
+- **`orchestratorPromptTemplate`**: the message handed to the Claude **orchestrator** launched from the dashboard's `Orchestrate` tab (or `mintree orchestrate`). It replaces the built-in default and supports:
+
+  | Placeholder | Replaced with                                          |
+  |-------------|--------------------------------------------------------|
+  | `{{ids}}`   | Comma-separated list of the selected ticket ids        |
+  | `{{count}}` | How many tickets were selected                         |
+
+  When omitted, mintree uses a built-in default that asks Claude to orchestrate the selected tickets with minimal intervention — parallelising via subagents unless dependencies force sequential work, creating a worktree per ticket with mintree, using the repo's skills, and moving each ticket to *in progress* on start and closing it when done.
+
 ---
 
 ## Daily flow
@@ -138,10 +173,19 @@ mintree dashboard
 
 Opens a full-screen TUI listing your assigned open issues (or work items), each row marked with the live state of its Claude session (`● active`, `! waiting`, `○ idle`, `— exited`, `· no session`). Rows are grouped by project board and Status. The right pane shows the issue body, labels, worktree info, PR status, and live session message.
 
+It has three tabs, switched with `←` / `→`:
+
+- **Issues** — your assigned open issues, grouped by project/Status.
+- **Worktrees** — orphaned worktrees (on disk under `.mintree/worktrees/` but no longer matching an open issue).
+- **Orchestrate** — the same issues as the Issues tab, but each row is a checkbox (`[ ]` / `[✔]`). Tick the tickets you want resolved and press `↵` to launch a single Claude **orchestrator** in the repo root that drives them to completion (parallel subagents when possible, sequential otherwise), creating a worktree per ticket with mintree. The message is built from `orchestratorPromptTemplate` (see above) or the built-in default.
+
 | Shortcut | Action                                                                |
 |----------|-----------------------------------------------------------------------|
-| `↑/↓` or `j/k` | Move between issues                                             |
-| `↵`      | Resume Claude in the existing worktree, or open the create overlay if there's none |
+| `←/→`    | Switch tab (Issues → Worktrees → Orchestrate)                         |
+| `↑/↓` or `j/k` | Move between rows                                               |
+| `↵`      | Issues/Worktrees: resume Claude in the existing worktree, or open the create overlay. Orchestrate: launch the orchestrator over the checked tickets |
+| `Space`  | Orchestrate tab: toggle the ticket under the cursor                   |
+| `a`      | Orchestrate tab: select / deselect all visible tickets               |
 | `w`      | Always open the create overlay (type + kebab description)             |
 | `d`      | Delete the selected worktree (confirmation overlay)                   |
 | `r`      | Manual refresh (auto-refreshes silently every 5 min)                  |
@@ -173,6 +217,11 @@ mintree worktree list --pr                     # also fetch PR status per branch
 mintree worktree remove fix/55-bug             # drop worktree but keep branch + session_id
 mintree worktree remove fix/55-bug --force     # discard uncommitted changes too
 mintree worktree clean                         # sweep worktrees whose PR is merged/closed
+
+# Launch a Claude orchestrator over a batch of tickets (renders
+# orchestratorPromptTemplate, or the built-in default)
+mintree orchestrate VAL-81 VAL-84 VAL-82
+mintree orchestrate VAL-81 VAL-84 -m auto
 ```
 
 `mt`, `mtw`, `mtn` are shell aliases the wrapper installs for `mintree`, `mintree worktree`, and an interactive "name a branch" shortcut.

package/dist/commands/dashboard.js

@@ -12,8 +12,10 @@ import { getLatestVersion, isNewerVersion } from "../lib/version.js";
 import { ALLOWED_TYPES } from "../lib/branch.js";
 import { runCreate, runCreateDetached, } from "../lib/worktreeCreate.js";
 import { runRemove, runRemoveByPath } from "../lib/worktreeRemove.js";
-import { buildCreateMarkers, emitMarkers } from "../lib/markers.js";
+import { writePromptFile } from "../lib/worktreeCreate.js";
+import { buildCreateMarkers, buildOrchestrateMarkers, emitMarkers } from "../lib/markers.js";
 import { readMetadata } from "../lib/metadata.js";
+import { defaultOrchestratorPrompt, renderOrchestratorTemplate, renderPromptTemplate, } from "../lib/promptTemplate.js";
 import { createProvider } from "../lib/providers/index.js";
 import { loadDashboard } from "../lib/dashboard.js";
 import { priorityDisplay } from "../lib/priority.js";
@@ -32,15 +34,27 @@ function issueMatchesFilter(d, filter) {
     return d.issue.id.replace(/\D/g, "").includes(filter);
 }
 function tabIssues(issues, tab, filter = "") {
-    return issues.filter((d) => (tab === "issues" ? !isOrphan(d) : isOrphan(d)) && issueMatchesFilter(d, filter));
+    // Orchestrate shows the same set as Issues (open issues assigned to you,
+    // non-orphan); only Worktrees flips to the orphan set.
+    return issues.filter((d) => (tab === "worktrees" ? isOrphan(d) : !isOrphan(d)) && issueMatchesFilter(d, filter));
+}
+function tabIndex(s, tab) {
+    if (tab === "issues")
+        return s.issuesIndex;
+    if (tab === "worktrees")
+        return s.worktreesIndex;
+    return s.orchestrateIndex;
 }
 function currentSelected(s) {
     const displayed = tabIssues(s.issues, s.activeTab, s.filter);
-    const selectedIndex = s.activeTab === "issues" ? s.issuesIndex : s.worktreesIndex;
-    return { displayed, selectedIndex };
+    return { displayed, selectedIndex: tabIndex(s, s.activeTab) };
 }
 function withSelectedIndex(s, next) {
-    return s.activeTab === "issues" ? { ...s, issuesIndex: next } : { ...s, worktreesIndex: next };
+    if (s.activeTab === "issues")
+        return { ...s, issuesIndex: next };
+    if (s.activeTab === "worktrees")
+        return { ...s, worktreesIndex: next };
+    return { ...s, orchestrateIndex: next };
 }
 // xterm/iTerm/etc switch to the alternate screen buffer with these escape
 // codes. Using the buffer means the dashboard owns the whole window for its
@@ -121,11 +135,18 @@ function kebabize(title) {
  * Default prompt seeded into the overlay's Prompt field when the user opens
  * `w` for an issue. Single-line on purpose — `ink-text-input` is one-line,
  * so multi-line templates render weirdly when the user tabs in to edit.
- * Provider-aware: GitHub issues get the `#<n>` + `gh issue view` form;
- * Linear issues (id like `FE-123`) get the bare id + the issue URL, since
- * `gh` can't read Linear and `#` isn't Linear's notation.
+ *
+ * When the repo configures a `promptTemplate` in `.mintree/metadata.json`,
+ * it wins: the `{{id}}`, `{{title}}` and `{{url}}` placeholders are rendered
+ * and the result seeds the field. Otherwise we fall back to the built-in,
+ * provider-aware default: GitHub issues get the `#<n>` + `gh issue view`
+ * form; Linear issues (id like `FE-123`) get the bare id + the issue URL,
+ * since `gh` can't read Linear and `#` isn't Linear's notation.
  */
-function defaultPromptForIssue(id, title, url) {
+function defaultPromptForIssue(id, title, url, template) {
+    if (template) {
+        return renderPromptTemplate(template, { id, title, url });
+    }
     const isTeamPrefixed = /^[A-Z][A-Z0-9_]*-\d+$/.test(id);
     if (isTeamPrefixed) {
         return `Empezá a trabajar el ticket ${id} (${title}). Abrí ${url} para leer el contexto completo y seguí las convenciones del repo.`;
@@ -175,12 +196,18 @@ function useTerminalSize() {
     }, [stdout]);
     return size;
 }
-function HeaderRow({ repoName, claudeVersion, issueCount, worktreeCount, activeTab, updateAvailable, }) {
+// Tab order for ← / → cycling.
+const TAB_ORDER = ["issues", "worktrees", "orchestrate"];
+function TabChip({ label, active }) {
+    return active ? (_jsx(Text, { bold: true, backgroundColor: "cyan", color: "black", children: label })) : (_jsx(Text, { dimColor: true, children: label }));
+}
+function HeaderRow({ repoName, claudeVersion, issueCount, worktreeCount, orchestrateCount, activeTab, updateAvailable, }) {
     const issuesLabel = ` Issues (${issueCount}) `;
     const worktreesLabel = ` Worktrees (${worktreeCount}) `;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "green", children: "mintree" }), _jsx(Text, { dimColor: true, children: `  v${mintreeVersion}` }), updateAvailable && _jsx(Text, { color: "yellow", children: " (*)" }), claudeVersion && _jsx(Text, { dimColor: true, children: `   ·   claude ${claudeVersion}` }), repoName && _jsx(Text, { dimColor: true, children: `   ·   ${repoName}` })] }), _jsxs(Box, { children: [activeTab === "issues" ? (_jsx(Text, { bold: true, backgroundColor: "cyan", color: "black", children: issuesLabel })) : (_jsx(Text, { dimColor: true, children: issuesLabel })), _jsx(Text, { children: " " }), activeTab === "worktrees" ? (_jsx(Text, { bold: true, backgroundColor: "cyan", color: "black", children: worktreesLabel })) : (_jsx(Text, { dimColor: true, children: worktreesLabel })), _jsx(Text, { dimColor: true, children: "   ← / → switch tab" })] })] }));
+    const orchestrateLabel = orchestrateCount > 0 ? ` Orchestrate (${orchestrateCount}) ` : ` Orchestrate `;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "green", children: "mintree" }), _jsx(Text, { dimColor: true, children: `  v${mintreeVersion}` }), updateAvailable && _jsx(Text, { color: "yellow", children: " (*)" }), claudeVersion && _jsx(Text, { dimColor: true, children: `   ·   claude ${claudeVersion}` }), repoName && _jsx(Text, { dimColor: true, children: `   ·   ${repoName}` })] }), _jsxs(Box, { children: [_jsx(TabChip, { label: issuesLabel, active: activeTab === "issues" }), _jsx(Text, { children: " " }), _jsx(TabChip, { label: worktreesLabel, active: activeTab === "worktrees" }), _jsx(Text, { children: " " }), _jsx(TabChip, { label: orchestrateLabel, active: activeTab === "orchestrate" }), _jsx(Text, { dimColor: true, children: "   ← / → switch tab" })] })] }));
 }
-function FooterRow({ phase, overlayKind, latestVersion, listWidth, }) {
+function FooterRow({ phase, overlayKind, latestVersion, listWidth, activeTab, selectedCount, }) {
     if (phase === "error") {
         return (_jsx(Box, { children: _jsx(Text, { dimColor: true, children: "q quit" }) }));
     }
@@ -190,6 +217,11 @@ function FooterRow({ phase, overlayKind, latestVersion, listWidth, }) {
     if (overlayKind === "remove") {
         return (_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "y/Y" }), _jsx(Text, { dimColor: true, children: " confirm " }), _jsx(Text, { bold: true, children: "n/Esc" }), _jsx(Text, { dimColor: true, children: " cancel" })] }));
     }
+    // Orchestrate tab: selection-driven controls instead of the per-ticket
+    // work/open/remove actions.
+    if (activeTab === "orchestrate") {
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "j/k" }), _jsx(Text, { dimColor: true, children: " nav " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " Space" }), _jsx(Text, { dimColor: true, children: " toggle " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " a" }), _jsx(Text, { dimColor: true, children: " all " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " \u21B5" }), _jsxs(Text, { dimColor: true, children: [" orchestrate", selectedCount ? ` (${selectedCount})` : "", " "] }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " q" }), _jsx(Text, { dimColor: true, children: " quit" })] }), latestVersion && (_jsxs(Box, { children: [_jsx(Text, { color: "yellow", children: "(*)" }), _jsx(Text, { dimColor: true, children: ` new version available — v${latestVersion} · npm i -g mintree` })] }))] }));
+    }
     // Two-column footer like santree: common navigation/dashboard commands
     // align under the left (list) pane; ticket-specific actions align under
     // the right (detail) pane. Falls back to a single inline row when no
@@ -228,7 +260,7 @@ function CreateStepIcon({ kind }) {
         return _jsx(Text, { color: "yellow", children: "!" });
     return _jsx(Text, { color: "cyan", children: "\u25CB" });
 }
-function IssueListRow({ d, selected, identifierWidth, rowWidth, }) {
+function IssueListRow({ d, selected, identifierWidth, rowWidth, checkbox, }) {
     // Display the issue id raw (e.g. "FE-123", "100"). The `#` prefix is a
     // GitHub convention that reads as noise for Linear's already-prefixed
     // ids, and dropping it across the board keeps the dashboard provider-
@@ -242,12 +274,14 @@ function IssueListRow({ d, selected, identifierWidth, rowWidth, }) {
     // priority. See lib/priority.ts.
     const prio = priorityDisplay(d.issue.priority);
     const title = d.issue.title;
+    const checkPrefix = checkbox === undefined ? "  " : checkbox === "on" ? "[✔] " : "[ ] ";
+    const checkColor = checkbox === "on" ? "green" : undefined;
     // The leading-dot Text and the rest are nested under a single Text so the
     // selection background paints the whole row in one contiguous block.
     // `wrap="truncate"` clamps the row to a single line and Ink renders an
     // ellipsis at the cut. The outer Box has a fixed width so the wrap
     // behaviour knows where to truncate.
-    return (_jsx(Box, { width: rowWidth, children: _jsxs(Text, { wrap: "truncate", backgroundColor: selected ? "blue" : undefined, color: selected ? "white" : undefined, children: ["  ", _jsx(Text, { color: selected ? "white" : dotColor, children: "\u25CF" }), " ", _jsx(Text, { color: selected ? "white" : prio.color, children: prio.icon }), ` ${idText}  ${title}`] }) }));
+    return (_jsx(Box, { width: rowWidth, children: _jsxs(Text, { wrap: "truncate", backgroundColor: selected ? "blue" : undefined, color: selected ? "white" : undefined, children: [_jsx(Text, { color: selected ? "white" : checkColor, children: checkPrefix }), _jsx(Text, { color: selected ? "white" : dotColor, children: "\u25CF" }), " ", _jsx(Text, { color: selected ? "white" : prio.color, children: prio.icon }), ` ${idText}  ${title}`] }) }));
 }
 // A project board header — the top level of the grouped issue list. Mirrors
 // the bold project name + dim count seen in the santree dashboard.
@@ -398,7 +432,7 @@ function windowListRows(listRows, selectedIndex, viewportRows) {
 }
 // Renders a single grouped-list row — used for both the sticky header region
 // and the scrollable body so the two stay visually identical.
-function ListRowView({ row, selectedIndex, identifierWidth, width, }) {
+function ListRowView({ row, selectedIndex, identifierWidth, width, selectedIds, }) {
     if (row.kind === "spacer")
         return _jsx(Text, { children: " " });
     if (row.kind === "project") {
@@ -407,7 +441,7 @@ function ListRowView({ row, selectedIndex, identifierWidth, width, }) {
     if (row.kind === "status") {
         return _jsx(StatusHeaderRow, { name: row.name, color: row.color, count: row.count, width: width });
     }
-    return (_jsx(IssueListRow, { d: row.d, selected: row.index === selectedIndex, identifierWidth: identifierWidth, rowWidth: width }));
+    return (_jsx(IssueListRow, { d: row.d, selected: row.index === selectedIndex, identifierWidth: identifierWidth, rowWidth: width, checkbox: selectedIds ? (selectedIds.has(row.d.issue.id) ? "on" : "off") : undefined }));
 }
 // Word-wraps a single line at `width` columns, breaking on the last space
 // before the limit when that yields a reasonable cut. Falls back to a hard
@@ -687,22 +721,42 @@ export default function Dashboard() {
             const activeTab = prevReady?.activeTab ?? "issues";
             const previousIssuesIndex = prevReady?.issuesIndex ?? 0;
             const previousWorktreesIndex = prevReady?.worktreesIndex ?? 0;
+            const previousOrchestrateIndex = prevReady?.orchestrateIndex ?? 0;
             const previousOverlay = prevReady?.overlay ?? null;
             const previousToast = prevReady?.toast ?? null;
             const previousScroll = prevReady?.detailScrollOffset ?? 0;
             const filter = prevReady?.filter ?? "";
             const issuesList = tabIssues(issues, "issues", filter);
             const worktreesList = tabIssues(issues, "worktrees", filter);
+            const orchestrateList = tabIssues(issues, "orchestrate", filter);
             const issuesIndex = Math.min(previousIssuesIndex, Math.max(0, issuesList.length - 1));
             const worktreesIndex = Math.min(previousWorktreesIndex, Math.max(0, worktreesList.length - 1));
+            const orchestrateIndex = Math.min(previousOrchestrateIndex, Math.max(0, orchestrateList.length - 1));
+            // Keep only checked ids that still exist among the open issues, so a
+            // resolved/closed ticket drops out of the batch instead of lingering.
+            const liveIds = new Set(issues.map((d) => d.issue.id));
+            const selectedIds = new Set([...(prevReady?.selectedIds ?? [])].filter((id) => liveIds.has(id)));
             // Preserve scroll only when the active tab's selected issue still
             // resolves to the same row — clamping or list churn means the user
             // is now reading something else.
             const prevDisplayed = prevReady ? tabIssues(prevReady.issues, activeTab, filter) : [];
-            const nextDisplayed = activeTab === "issues" ? issuesList : worktreesList;
-            const prevSelectedId = prevDisplayed[activeTab === "issues" ? previousIssuesIndex : previousWorktreesIndex]?.issue
-                .id ?? null;
-            const nextSelectedId = nextDisplayed[activeTab === "issues" ? issuesIndex : worktreesIndex]?.issue.id ?? null;
+            const nextDisplayed = activeTab === "worktrees"
+                ? worktreesList
+                : activeTab === "orchestrate"
+                    ? orchestrateList
+                    : issuesList;
+            const prevIdx = activeTab === "worktrees"
+                ? previousWorktreesIndex
+                : activeTab === "orchestrate"
+                    ? previousOrchestrateIndex
+                    : previousIssuesIndex;
+            const nextIdx = activeTab === "worktrees"
+                ? worktreesIndex
+                : activeTab === "orchestrate"
+                    ? orchestrateIndex
+                    : issuesIndex;
+            const prevSelectedId = prevDisplayed[prevIdx]?.issue.id ?? null;
+            const nextSelectedId = nextDisplayed[nextIdx]?.issue.id ?? null;
             const detailScrollOffset = prevSelectedId !== null && prevSelectedId === nextSelectedId ? previousScroll : 0;
             return {
                 phase: "ready",
@@ -710,6 +764,8 @@ export default function Dashboard() {
                 activeTab,
                 issuesIndex,
                 worktreesIndex,
+                orchestrateIndex,
+                selectedIds,
                 detailScrollOffset,
                 refreshing: false,
                 overlay: previousOverlay,
@@ -839,7 +895,14 @@ export default function Dashboard() {
         // Esc clears an active numeric filter before it falls through to quit —
         // so the user can back out of a search without leaving the dashboard.
         if (key.escape && state.phase === "ready" && state.filter) {
-            setState({ ...state, filter: "", issuesIndex: 0, worktreesIndex: 0, detailScrollOffset: 0 });
+            setState({
+                ...state,
+                filter: "",
+                issuesIndex: 0,
+                worktreesIndex: 0,
+                orchestrateIndex: 0,
+                detailScrollOffset: 0,
+            });
             return;
         }
         if (input === "q" || key.escape || (input === "c" && key.ctrl)) {
@@ -858,6 +921,7 @@ export default function Dashboard() {
                 filter: state.filter + input,
                 issuesIndex: 0,
                 worktreesIndex: 0,
+                orchestrateIndex: 0,
                 detailScrollOffset: 0,
             });
             return;
@@ -868,14 +932,17 @@ export default function Dashboard() {
                 filter: state.filter.slice(0, -1),
                 issuesIndex: 0,
                 worktreesIndex: 0,
+                orchestrateIndex: 0,
                 detailScrollOffset: 0,
             });
             return;
         }
         if (key.leftArrow || key.rightArrow) {
-            // Two tabs only — either arrow toggles. Per-tab indices are
-            // preserved, so the user returns to the row they left.
-            const next = state.activeTab === "issues" ? "worktrees" : "issues";
+            // Cycle through the three tabs; → advances, ← goes back. Per-tab
+            // indices are preserved, so the user returns to the row they left.
+            const cur = TAB_ORDER.indexOf(state.activeTab);
+            const delta = key.leftArrow ? -1 : 1;
+            const next = TAB_ORDER[(cur + delta + TAB_ORDER.length) % TAB_ORDER.length];
             setState({ ...state, activeTab: next, detailScrollOffset: 0 });
             return;
         }
@@ -910,6 +977,34 @@ export default function Dashboard() {
             void refresh();
             return;
         }
+        // Orchestrate tab: Space toggles the ticket under the cursor; `a`
+        // toggles all visible tickets at once.
+        if (state.activeTab === "orchestrate" && input === " ") {
+            const { displayed, selectedIndex } = currentSelected(state);
+            const issue = displayed[selectedIndex];
+            if (!issue)
+                return;
+            const next = new Set(state.selectedIds);
+            if (next.has(issue.issue.id))
+                next.delete(issue.issue.id);
+            else
+                next.add(issue.issue.id);
+            setState({ ...state, selectedIds: next });
+            return;
+        }
+        if (state.activeTab === "orchestrate" && input === "a") {
+            const { displayed } = currentSelected(state);
+            const allSelected = displayed.length > 0 && displayed.every((d) => state.selectedIds.has(d.issue.id));
+            const next = new Set(state.selectedIds);
+            for (const d of displayed) {
+                if (allSelected)
+                    next.delete(d.issue.id);
+                else
+                    next.add(d.issue.id);
+            }
+            setState({ ...state, selectedIds: next });
+            return;
+        }
         if (input === "o") {
             const { displayed, selectedIndex } = currentSelected(state);
             const issue = displayed[selectedIndex];
@@ -932,6 +1027,12 @@ export default function Dashboard() {
             return;
         }
         if (key.return) {
+            // Orchestrate tab: Enter launches the orchestrator over the checked
+            // tickets instead of resuming/creating a single worktree.
+            if (state.activeTab === "orchestrate") {
+                launchOrchestrator();
+                return;
+            }
             const { displayed, selectedIndex } = currentSelected(state);
             const issue = displayed[selectedIndex];
             if (!issue)
@@ -968,6 +1069,41 @@ export default function Dashboard() {
             return;
         }
     });
+    function launchOrchestrator() {
+        if (state.phase !== "ready")
+            return;
+        const { displayed } = currentSelected(state);
+        // Preserve the display order; only keep ids that are actually visible
+        // and checked.
+        const ids = displayed.filter((d) => state.selectedIds.has(d.issue.id)).map((d) => d.issue.id);
+        if (ids.length === 0) {
+            setState({
+                ...state,
+                toast: {
+                    kind: "error",
+                    text: "Seleccioná al menos un ticket (Space) antes de orquestar.",
+                },
+            });
+            return;
+        }
+        const root = findMainRepoRoot();
+        if (!root) {
+            setState({ ...state, toast: { kind: "error", text: "No estás en un repositorio git." } });
+            return;
+        }
+        const meta = readMetadata(root);
+        const idList = ids.join(", ");
+        const prompt = meta.orchestratorPromptTemplate
+            ? renderOrchestratorTemplate(meta.orchestratorPromptTemplate, {
+                ids: idList,
+                count: ids.length,
+            })
+            : defaultOrchestratorPrompt(idList);
+        const promptFile = writePromptFile(prompt);
+        const permissionMode = meta.defaultPermissionMode ?? "default";
+        emitMarkers(buildOrchestrateMarkers({ repoRoot: root, promptFile, permissionMode }));
+        exit();
+    }
     function openCreateOverlay(issue) {
         if (state.phase !== "ready")
             return;
@@ -976,7 +1112,8 @@ export default function Dashboard() {
         // (its `branchName`) over the synthesised `<type>/<issue>-<desc>` form —
         // that's the convention those repos actually follow. Falls back to the
         // convention form when the issue has no branchName.
-        const provider = root ? readMetadata(root).provider : undefined;
+        const meta = root ? readMetadata(root) : undefined;
+        const provider = meta?.provider;
         const linearBranch = provider === "linear" && issue.issue.branchName ? issue.issue.branchName : null;
         setState({
             ...state,
@@ -988,7 +1125,7 @@ export default function Dashboard() {
                 type: "feat",
                 desc: kebabize(issue.issue.title) || `issue-${issue.issue.id}`,
                 linearBranch,
-                prompt: defaultPromptForIssue(issue.issue.id, issue.issue.title, issue.issue.url),
+                prompt: defaultPromptForIssue(issue.issue.id, issue.issue.title, issue.issue.url, meta?.promptTemplate),
                 field: "branchMode",
                 error: null,
                 conventionDoc: root ? findBranchConventionDoc(root) : null,
@@ -1231,11 +1368,13 @@ export default function Dashboard() {
     if (state.phase === "error") {
         return (_jsxs(Box, { width: columns, height: rows, flexDirection: "column", borderStyle: "round", borderColor: "red", paddingX: 1, children: [_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", state.message] }), state.hint && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", state.hint] }) })), _jsx(Box, { marginTop: 1, children: _jsx(FooterRow, { phase: "error" }) })] }));
     }
-    const { issues, refreshing, overlay, toast, activeTab, filter } = state;
+    const { issues, refreshing, overlay, toast, activeTab, filter, selectedIds } = state;
     const { displayed, selectedIndex } = currentSelected(state);
     const selected = displayed[selectedIndex] ?? null;
     const issuesTabCount = issues.reduce((n, d) => (isOrphan(d) ? n : n + 1), 0);
     const worktreesTabCount = issues.length - issuesTabCount;
+    // The Orchestrate chip shows how many tickets are currently checked.
+    const orchestrateTabCount = selectedIds.size;
     const onOverlayDescChange = (next) => {
         if (state.phase !== "ready" || !state.overlay)
             return;
@@ -1283,9 +1422,9 @@ export default function Dashboard() {
         : displayed.map((d, index) => ({ kind: "issue", d, index }));
     const listView = windowListRows(listRows, selectedIndex, listVisibleRows);
     const listContentWidth = Math.max(8, listWidth - 4);
-    return (_jsxs(Box, { flexDirection: "column", width: columns, height: rows, children: [_jsx(Box, { paddingX: 1, paddingTop: 0, flexDirection: "column", children: _jsx(HeaderRow, { repoName: repoName, claudeVersion: claudeVersion, issueCount: issuesTabCount, worktreeCount: worktreesTabCount, activeTab: activeTab, updateAvailable: latestVersion !== null }) }), overlay ? (_jsx(Box, { flexGrow: 1, flexDirection: "column", borderStyle: "round", borderColor: overlay.kind === "remove" ? "yellow" : "cyan", children: overlay.kind === "create" ? (_jsx(CreateOverlayView, { overlay: overlay, onDescChange: onOverlayDescChange, onPromptChange: onOverlayPromptChange })) : (_jsx(RemoveOverlayView, { overlay: overlay })) })) : (_jsxs(Box, { flexGrow: 1, flexDirection: "row", children: [_jsx(Box, { width: listWidth, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: displayed.length === 0 ? (_jsx(Text, { dimColor: true, children: filter
+    return (_jsxs(Box, { flexDirection: "column", width: columns, height: rows, children: [_jsx(Box, { paddingX: 1, paddingTop: 0, flexDirection: "column", children: _jsx(HeaderRow, { repoName: repoName, claudeVersion: claudeVersion, issueCount: issuesTabCount, worktreeCount: worktreesTabCount, orchestrateCount: orchestrateTabCount, activeTab: activeTab, updateAvailable: latestVersion !== null }) }), overlay ? (_jsx(Box, { flexGrow: 1, flexDirection: "column", borderStyle: "round", borderColor: overlay.kind === "remove" ? "yellow" : "cyan", children: overlay.kind === "create" ? (_jsx(CreateOverlayView, { overlay: overlay, onDescChange: onOverlayDescChange, onPromptChange: onOverlayPromptChange })) : (_jsx(RemoveOverlayView, { overlay: overlay })) })) : (_jsxs(Box, { flexGrow: 1, flexDirection: "row", children: [_jsx(Box, { width: listWidth, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: displayed.length === 0 ? (_jsx(Text, { dimColor: true, children: filter
                                 ? `No tickets match #${filter} — Esc to clear the filter.`
-                                : activeTab === "issues"
-                                    ? "No open issues assigned to you in this repo."
-                                    : "No orphaned worktrees — anything in `.mintree/worktrees/` matches an open issue." })) : (_jsxs(_Fragment, { children: [listView.sticky.map((row, i) => (_jsx(ListRowView, { row: row, selectedIndex: selectedIndex, identifierWidth: identifierWidth, width: listContentWidth }, `sticky-${i}`))), listView.issuesAbove > 0 && (_jsxs(Text, { dimColor: true, children: ["\u2191 ", listView.issuesAbove, " more above"] })), listView.body.map((row, i) => (_jsx(ListRowView, { row: row, selectedIndex: selectedIndex, identifierWidth: identifierWidth, width: listContentWidth }, `body-${i}`))), listView.issuesBelow > 0 && (_jsxs(Text, { dimColor: true, children: ["\u2193 ", listView.issuesBelow, " more below"] }))] })) }), _jsx(Box, { width: detailWidth, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: _jsx(DetailPane, { d: selected, contentWidth: detailWidth - 4, contentHeight: detailContentHeight, scrollOffset: state.detailScrollOffset }) })] })), _jsxs(Box, { paddingX: 1, flexDirection: "column", children: [filter && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", bold: true, children: `⌕ #${filter}` }), _jsx(Text, { dimColor: true, children: ` · ${displayed.length} match${displayed.length === 1 ? "" : "es"} · Esc clear` })] })), toast && (_jsx(Box, { children: _jsxs(Text, { color: toast.kind === "success" ? "green" : toast.kind === "error" ? "red" : "cyan", children: [toast.kind === "success" ? "✓ " : toast.kind === "error" ? "✗ " : "· ", toast.text] }) })), refreshing && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { dimColor: true, children: " refreshing" })] })), _jsx(FooterRow, { phase: "ready", overlayKind: overlay?.kind, latestVersion: latestVersion, listWidth: listWidth })] })] }));
+                                : activeTab === "worktrees"
+                                    ? "No orphaned worktrees — anything in `.mintree/worktrees/` matches an open issue."
+                                    : "No open issues assigned to you in this repo." })) : (_jsxs(_Fragment, { children: [listView.sticky.map((row, i) => (_jsx(ListRowView, { row: row, selectedIndex: selectedIndex, identifierWidth: identifierWidth, width: listContentWidth, selectedIds: activeTab === "orchestrate" ? selectedIds : undefined }, `sticky-${i}`))), listView.issuesAbove > 0 && (_jsxs(Text, { dimColor: true, children: ["\u2191 ", listView.issuesAbove, " more above"] })), listView.body.map((row, i) => (_jsx(ListRowView, { row: row, selectedIndex: selectedIndex, identifierWidth: identifierWidth, width: listContentWidth, selectedIds: activeTab === "orchestrate" ? selectedIds : undefined }, `body-${i}`))), listView.issuesBelow > 0 && (_jsxs(Text, { dimColor: true, children: ["\u2193 ", listView.issuesBelow, " more below"] }))] })) }), _jsx(Box, { width: detailWidth, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: _jsx(DetailPane, { d: selected, contentWidth: detailWidth - 4, contentHeight: detailContentHeight, scrollOffset: state.detailScrollOffset }) })] })), _jsxs(Box, { paddingX: 1, flexDirection: "column", children: [filter && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", bold: true, children: `⌕ #${filter}` }), _jsx(Text, { dimColor: true, children: ` · ${displayed.length} match${displayed.length === 1 ? "" : "es"} · Esc clear` })] })), toast && (_jsx(Box, { children: _jsxs(Text, { color: toast.kind === "success" ? "green" : toast.kind === "error" ? "red" : "cyan", children: [toast.kind === "success" ? "✓ " : toast.kind === "error" ? "✗ " : "· ", toast.text] }) })), refreshing && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { dimColor: true, children: " refreshing" })] })), _jsx(FooterRow, { phase: "ready", overlayKind: overlay?.kind, latestVersion: latestVersion, listWidth: listWidth, activeTab: activeTab, selectedCount: orchestrateTabCount })] })] }));
 }

package/dist/commands/orchestrate.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export declare const description = "Launch a Claude orchestrator in the repo root to resolve a batch of tickets";
+export declare const args: z.ZodArray<z.ZodString>;
+export declare const options: z.ZodObject<{
+    prompt: z.ZodOptional<z.ZodString>;
+    promptFile: z.ZodOptional<z.ZodString>;
+    permissionMode: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        auto: "auto";
+    }>>;
+}, z.core.$strip>;
+type Props = {
+    args: z.infer<typeof args>;
+    options: z.infer<typeof options>;
+};
+export default function Orchestrate({ args: ids, options }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/commands/orchestrate.js

@@ -0,0 +1,154 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Box, Text } from "ink";
+import Spinner from "ink-spinner";
+import { argument, option } from "pastel";
+import { z } from "zod";
+import { randomUUID } from "crypto";
+import { readFileSync, unlinkSync } from "fs";
+import { findMainRepoRoot, getMintreeDir, pathExists } from "../lib/git.js";
+import { readMetadata } from "../lib/metadata.js";
+import { launchClaude, PERMISSION_MODES } from "../lib/claude.js";
+import { defaultOrchestratorPrompt, renderOrchestratorTemplate } from "../lib/promptTemplate.js";
+export const description = "Launch a Claude orchestrator in the repo root to resolve a batch of tickets";
+export const args = z.array(z.string()).describe(argument({
+    name: "ids",
+    description: "Ticket ids to orchestrate (e.g. VAL-81 VAL-84). Renders the orchestratorPromptTemplate (or the built-in default). Ignored when --prompt / --prompt-file is given.",
+}));
+export const options = z.object({
+    prompt: z
+        .string()
+        .optional()
+        .describe(option({
+        description: "Literal orchestrator message (overrides the template/ids).",
+    })),
+    promptFile: z
+        .string()
+        .optional()
+        .describe(option({
+        description: "Read the orchestrator message from this file (deleted after read). Used by the dashboard's Orchestrate tab. Mutually exclusive with --prompt.",
+    })),
+    permissionMode: z
+        .enum(PERMISSION_MODES)
+        .optional()
+        .describe(option({
+        description: `Claude --permission-mode (one of: ${PERMISSION_MODES.join(", ")}). Defaults to metadata.defaultPermissionMode, else "default".`,
+        alias: "m",
+    })),
+});
+function resolve(cwd, ids, opts) {
+    if (opts.prompt && opts.promptFile) {
+        return { ok: false, message: "--prompt and --prompt-file are mutually exclusive." };
+    }
+    const repoRoot = findMainRepoRoot(cwd);
+    if (!repoRoot) {
+        return {
+            ok: false,
+            message: "Not in a git repository.",
+            hint: "Run `mintree orchestrate` from inside a mintree-enabled repo.",
+        };
+    }
+    if (!pathExists(getMintreeDir(repoRoot))) {
+        return {
+            ok: false,
+            message: ".mintree/ not found in this repo.",
+            hint: "Run `mintree init` first.",
+        };
+    }
+    // Resolve the orchestrator message. Priority: --prompt-file (the dashboard
+    // path) > --prompt (literal) > render the template from the ticket ids.
+    let prompt;
+    if (opts.promptFile) {
+        try {
+            prompt = readFileSync(opts.promptFile, "utf-8");
+        }
+        catch {
+            return {
+                ok: false,
+                message: `Could not read --prompt-file ${opts.promptFile}.`,
+            };
+        }
+        try {
+            unlinkSync(opts.promptFile);
+        }
+        catch {
+            // Cleanup failure is non-fatal.
+        }
+    }
+    else if (opts.prompt) {
+        prompt = opts.prompt;
+    }
+    else if (ids.length > 0) {
+        const idList = ids.join(", ");
+        const template = readMetadata(repoRoot).orchestratorPromptTemplate;
+        prompt = template
+            ? renderOrchestratorTemplate(template, { ids: idList, count: ids.length })
+            : defaultOrchestratorPrompt(idList);
+    }
+    if (!prompt || prompt.trim().length === 0) {
+        return {
+            ok: false,
+            message: "Nothing to orchestrate.",
+            hint: "Pass ticket ids (e.g. `mintree orchestrate VAL-81 VAL-84`) or a --prompt.",
+        };
+    }
+    const permissionMode = opts.permissionMode ?? readMetadata(repoRoot).defaultPermissionMode ?? "default";
+    return {
+        ok: true,
+        data: { repoRoot, sessionId: randomUUID(), permissionMode, prompt },
+    };
+}
+export default function Orchestrate({ args: ids, options }) {
+    const [state, setState] = useState({ phase: "loading" });
+    useEffect(() => {
+        setTimeout(() => {
+            const result = resolve(process.cwd(), ids, options);
+            if (!result.ok) {
+                setState({ phase: "error", message: result.message, hint: result.hint });
+                return;
+            }
+            setState({ phase: "launching", resolved: result.data });
+        }, 0);
+    }, []);
+    useEffect(() => {
+        if (state.phase !== "launching")
+            return;
+        const { resolved } = state;
+        try {
+            const child = launchClaude({
+                permissionMode: resolved.permissionMode,
+                sessionId: resolved.sessionId,
+                resume: false,
+                prompt: resolved.prompt,
+                cwd: resolved.repoRoot,
+                remoteControlName: "orchestrator",
+            });
+            child.on("error", (err) => {
+                setState({ phase: "error", message: `Failed to launch claude: ${err.message}` });
+            });
+            child.on("close", (code) => {
+                process.exit(code ?? 0);
+            });
+        }
+        catch (err) {
+            setState({
+                phase: "error",
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }, [state.phase]);
+    if (state.phase === "loading") {
+        return (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Resolving repo..." })] }));
+    }
+    if (state.phase === "error") {
+        return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", state.message] }), state.hint && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", state.hint] }) }))] }));
+    }
+    const { resolved } = state;
+    const sessionShort = resolved.sessionId.slice(0, 8);
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree orchestrate" }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", resolved.repoRoot] })] }), _jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "session: " }), _jsxs(Text, { children: [sessionShort, "\u2026"] }), _jsx(Text, { dimColor: true, children: " (starting)" })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "permission-mode: " }), _jsx(Text, { children: resolved.permissionMode })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "prompt: " }), _jsxs(Text, { children: ["\"", truncate(resolved.prompt.replace(/\n/g, " "), 60), "\""] })] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "green", bold: true, children: "\u2713 Launching Claude orchestrator..." }) })] }));
+}
+function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    return s.slice(0, max - 1) + "…";
+}

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

@@ -3,7 +3,7 @@ export declare const description = "Launch Claude in the current worktree (creat
 export declare const options: z.ZodObject<{
     prompt: z.ZodOptional<z.ZodString>;
     promptFile: z.ZodOptional<z.ZodString>;
-    permissionMode: z.ZodDefault<z.ZodEnum<{
+    permissionMode: z.ZodOptional<z.ZodEnum<{
         default: "default";
         auto: "auto";
     }>>;

package/dist/commands/worktree/work.js

@@ -8,7 +8,7 @@ import { randomUUID } from "crypto";
 import { readFileSync, unlinkSync } from "fs";
 import * as path from "path";
 import { findMainRepoRoot, getMintreeDir, getWorktreesDir, getCurrentBranch, pathExists, } from "../../lib/git.js";
-import { getSessionId, setSessionId } from "../../lib/metadata.js";
+import { getSessionId, setSessionId, readMetadata } from "../../lib/metadata.js";
 import { launchClaude, PERMISSION_MODES } from "../../lib/claude.js";
 export const description = "Launch Claude in the current worktree (creates or resumes a session)";
 export const options = z.object({
@@ -26,13 +26,13 @@ export const options = z.object({
     })),
     permissionMode: z
         .enum(PERMISSION_MODES)
-        .default("default")
+        .optional()
         .describe(option({
-        description: `Claude --permission-mode (one of: ${PERMISSION_MODES.join(", ")})`,
+        description: `Claude --permission-mode (one of: ${PERMISSION_MODES.join(", ")}). Defaults to metadata.defaultPermissionMode, else "default".`,
         alias: "m",
     })),
 });
-function resolve(cwd) {
+function resolve(cwd, flagPermissionMode) {
     const repoRoot = findMainRepoRoot(cwd);
     if (!repoRoot) {
         return {
@@ -93,6 +93,9 @@ function resolve(cwd) {
         setSessionId(repoRoot, issueId, sessionId);
         resume = false;
     }
+    // Effective permission mode: explicit `--permission-mode` flag wins, else
+    // the repo's `metadata.defaultPermissionMode`, else the stricter "default".
+    const permissionMode = flagPermissionMode ?? readMetadata(repoRoot).defaultPermissionMode ?? "default";
     return {
         ok: true,
         data: {
@@ -103,6 +106,7 @@ function resolve(cwd) {
             issueId,
             sessionId,
             resume,
+            permissionMode,
         },
     };
 }
@@ -118,7 +122,7 @@ export default function Work({ options }) {
                 });
                 return;
             }
-            const result = resolve(process.cwd());
+            const result = resolve(process.cwd(), options.permissionMode);
             if (!result.ok) {
                 setState({ phase: "error", message: result.message, hint: result.hint });
                 return;
@@ -151,7 +155,7 @@ export default function Work({ options }) {
         }
         try {
             const child = launchClaude({
-                permissionMode: options.permissionMode,
+                permissionMode: resolved.permissionMode,
                 sessionId: resolved.sessionId,
                 resume: resolved.resume,
                 prompt: effectivePrompt,
@@ -184,7 +188,7 @@ export default function Work({ options }) {
     const { resolved } = state;
     const sessionShort = resolved.sessionId.slice(0, 8);
     const action = resolved.resume ? "resuming" : "starting";
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree worktree work" }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", resolved.branch ?? `detached @ ${resolved.worktreeDirName}`] })] }), _jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "session: " }), _jsxs(Text, { children: [sessionShort, "\u2026"] }), _jsxs(Text, { dimColor: true, children: [" (", action, ")"] })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "permission-mode: " }), _jsx(Text, { children: options.permissionMode })] }), options.prompt && (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "initial prompt: " }), _jsxs(Text, { children: ["\"", truncate(options.prompt, 60), "\""] })] })), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "cwd: " }), _jsx(Text, { dimColor: true, children: resolved.worktreePath })] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "green", bold: true, children: "\u2713 Launching Claude..." }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree worktree work" }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", resolved.branch ?? `detached @ ${resolved.worktreeDirName}`] })] }), _jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "session: " }), _jsxs(Text, { children: [sessionShort, "\u2026"] }), _jsxs(Text, { dimColor: true, children: [" (", action, ")"] })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "permission-mode: " }), _jsx(Text, { children: resolved.permissionMode })] }), options.prompt && (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "initial prompt: " }), _jsxs(Text, { children: ["\"", truncate(options.prompt, 60), "\""] })] })), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "cwd: " }), _jsx(Text, { dimColor: true, children: resolved.worktreePath })] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "green", bold: true, children: "\u2713 Launching Claude..." }) })] }));
 }
 function truncate(s, max) {
     if (s.length <= max)

package/dist/lib/markers.d.ts

@@ -19,3 +19,14 @@ export type CreateMarkers = {
  * three work-related markers only when --work was on.
  */
 export declare function buildCreateMarkers(input: CreateMarkers): string[];
+export type OrchestrateMarkers = {
+    repoRoot: string;
+    promptFile: string;
+    permissionMode?: string;
+};
+/**
+ * Builds the marker block emitted when the dashboard launches the orchestrator
+ * from the Orchestrate tab. The shell wrapper cd's to `repoRoot` and then runs
+ * `mintree orchestrate --prompt-file <file> [--permission-mode <mode>]`.
+ */
+export declare function buildOrchestrateMarkers(input: OrchestrateMarkers): string[];

package/dist/lib/markers.js

@@ -41,3 +41,19 @@ export function buildCreateMarkers(input) {
     }
     return lines;
 }
+/**
+ * Builds the marker block emitted when the dashboard launches the orchestrator
+ * from the Orchestrate tab. The shell wrapper cd's to `repoRoot` and then runs
+ * `mintree orchestrate --prompt-file <file> [--permission-mode <mode>]`.
+ */
+export function buildOrchestrateMarkers(input) {
+    const lines = [
+        `MINTREE_CD:${input.repoRoot}`,
+        "MINTREE_ORCHESTRATE:1",
+        `MINTREE_ORCHESTRATE_PROMPT_FILE:${input.promptFile}`,
+    ];
+    if (input.permissionMode) {
+        lines.push(`MINTREE_PERMISSION_MODE:${input.permissionMode}`);
+    }
+    return lines;
+}

package/dist/lib/metadata.d.ts

@@ -1,3 +1,4 @@
+import { type PermissionMode } from "./claude.js";
 export type IssueMeta = {
     base_branch?: string;
     session_id?: string;
@@ -26,6 +27,9 @@ export type Metadata = {
     issues: Record<string, IssueMeta>;
     project?: ProjectMeta;
     linear?: LinearMeta;
+    defaultPermissionMode?: PermissionMode;
+    promptTemplate?: string;
+    orchestratorPromptTemplate?: string;
 };
 export declare function readMetadata(repoRoot: string): Metadata;
 export declare function writeMetadata(repoRoot: string, data: Metadata): void;

package/dist/lib/metadata.js

@@ -1,11 +1,21 @@
 import * as fs from "fs";
 import { getMetadataPath } from "./git.js";
+import { PERMISSION_MODES } from "./claude.js";
 const EMPTY = { version: 1, issues: {} };
 function sanitizeProvider(raw) {
     if (raw === "github" || raw === "linear")
         return raw;
     return undefined;
 }
+function sanitizePermissionMode(raw) {
+    return PERMISSION_MODES.includes(raw) ? raw : undefined;
+}
+function sanitizePromptTemplate(raw) {
+    return typeof raw === "string" && raw.trim().length > 0 ? raw : undefined;
+}
+function sanitizeOrchestratorPromptTemplate(raw) {
+    return typeof raw === "string" && raw.trim().length > 0 ? raw : undefined;
+}
 function sanitizeLinearTeam(raw) {
     if (typeof raw !== "object" || raw === null)
         return undefined;
@@ -77,6 +87,9 @@ export function readMetadata(repoRoot) {
         const project = sanitizeProject(parsed.project);
         const provider = sanitizeProvider(parsed.provider);
         const linear = sanitizeLinear(parsed.linear);
+        const defaultPermissionMode = sanitizePermissionMode(parsed.defaultPermissionMode);
+        const promptTemplate = sanitizePromptTemplate(parsed.promptTemplate);
+        const orchestratorPromptTemplate = sanitizeOrchestratorPromptTemplate(parsed.orchestratorPromptTemplate);
         return {
             version: 1,
             issues: typeof parsed.issues === "object" && parsed.issues !== null
@@ -85,6 +98,9 @@ export function readMetadata(repoRoot) {
             ...(provider ? { provider } : {}),
             ...(project ? { project } : {}),
             ...(linear ? { linear } : {}),
+            ...(defaultPermissionMode ? { defaultPermissionMode } : {}),
+            ...(promptTemplate ? { promptTemplate } : {}),
+            ...(orchestratorPromptTemplate ? { orchestratorPromptTemplate } : {}),
         };
     }
     catch {

package/dist/lib/promptTemplate.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Variables available to a `promptTemplate` in `.mintree/metadata.json`.
+ * Kept intentionally small — the template seeds Claude's first message, it
+ * doesn't need the whole issue object.
+ */
+export type PromptVars = {
+    id: string;
+    title: string;
+    url: string;
+};
+export declare const PROMPT_PLACEHOLDERS: readonly ["{{id}}", "{{title}}", "{{url}}"];
+/**
+ * Renders a `promptTemplate` by substituting the `{{id}}`, `{{title}}` and
+ * `{{url}}` placeholders with the issue's values. Whitespace inside the braces
+ * is tolerated (`{{ id }}`). Unknown placeholders are left untouched so a typo
+ * is visible in the launched prompt instead of silently vanishing.
+ */
+export declare function renderPromptTemplate(template: string, vars: PromptVars): string;
+/**
+ * Variables available to an `orchestratorPromptTemplate`. The orchestrator
+ * works a batch of tickets, so it only needs the list of ids and the count —
+ * not per-issue title/url (the orchestrator looks those up itself).
+ */
+export type OrchestratorVars = {
+    ids: string;
+    count: number;
+};
+export declare const ORCHESTRATOR_PLACEHOLDERS: readonly ["{{ids}}", "{{count}}"];
+/**
+ * Renders an `orchestratorPromptTemplate` by substituting the `{{ids}}` and
+ * `{{count}}` placeholders. Whitespace inside the braces is tolerated
+ * (`{{ ids }}`); unknown placeholders are left untouched so a typo is visible
+ * in the launched prompt instead of silently vanishing.
+ */
+export declare function renderOrchestratorTemplate(template: string, vars: OrchestratorVars): string;
+/**
+ * Built-in default for the orchestrator message, used when the repo doesn't
+ * configure an `orchestratorPromptTemplate`. Mirrors the manual flow the user
+ * was running by hand: act as an orchestrator over the selected tickets,
+ * resolve them with minimal intervention, parallelise via subagents unless
+ * dependencies force sequential work, and for each ticket follow the repo
+ * conventions, create the worktree with mintree, use the right skills, move it
+ * to "in progress" on start and close it when done.
+ */
+export declare function defaultOrchestratorPrompt(ids: string): string;

package/dist/lib/promptTemplate.js

@@ -0,0 +1,50 @@
+// Placeholder tokens a user can drop into their `promptTemplate`. Documented
+// here so the README and any future `init`/help output stay in sync.
+export const PROMPT_PLACEHOLDERS = ["{{id}}", "{{title}}", "{{url}}"];
+/**
+ * Renders a `promptTemplate` by substituting the `{{id}}`, `{{title}}` and
+ * `{{url}}` placeholders with the issue's values. Whitespace inside the braces
+ * is tolerated (`{{ id }}`). Unknown placeholders are left untouched so a typo
+ * is visible in the launched prompt instead of silently vanishing.
+ */
+export function renderPromptTemplate(template, vars) {
+    return template
+        .replace(/\{\{\s*id\s*\}\}/g, vars.id)
+        .replace(/\{\{\s*title\s*\}\}/g, vars.title)
+        .replace(/\{\{\s*url\s*\}\}/g, vars.url);
+}
+// Placeholder tokens for an `orchestratorPromptTemplate`. Kept in sync with
+// the README and any `init`/help output.
+export const ORCHESTRATOR_PLACEHOLDERS = ["{{ids}}", "{{count}}"];
+/**
+ * Renders an `orchestratorPromptTemplate` by substituting the `{{ids}}` and
+ * `{{count}}` placeholders. Whitespace inside the braces is tolerated
+ * (`{{ ids }}`); unknown placeholders are left untouched so a typo is visible
+ * in the launched prompt instead of silently vanishing.
+ */
+export function renderOrchestratorTemplate(template, vars) {
+    return template
+        .replace(/\{\{\s*ids\s*\}\}/g, vars.ids)
+        .replace(/\{\{\s*count\s*\}\}/g, String(vars.count));
+}
+/**
+ * Built-in default for the orchestrator message, used when the repo doesn't
+ * configure an `orchestratorPromptTemplate`. Mirrors the manual flow the user
+ * was running by hand: act as an orchestrator over the selected tickets,
+ * resolve them with minimal intervention, parallelise via subagents unless
+ * dependencies force sequential work, and for each ticket follow the repo
+ * conventions, create the worktree with mintree, use the right skills, move it
+ * to "in progress" on start and close it when done.
+ */
+export function defaultOrchestratorPrompt(ids) {
+    return [
+        `Quiero que hagas de orquestador con los tickets ${ids}.`,
+        "",
+        "La idea es que resuelvas esos tickets con la menor intervención mía posible.",
+        "Trabajá los tickets en paralelo creando subagentes (a no ser que tengan",
+        "dependencias entre sí y no se puedan paralelizar, en cuyo caso trabajalos",
+        "secuencialmente). Para cada ticket: seguí los lineamientos del repo, creá el",
+        "worktree usando mintree, usá las skills correctas para cada caso, poné el ticket",
+        'en "in progress" al empezar y cerralo al terminar.',
+    ].join("\n");
+}

package/dist/lib/worktreeCreate.d.ts

@@ -39,6 +39,12 @@ export type CreateResult = {
     message: string;
     hint?: string;
 };
+/**
+ * Stashes a `--prompt` value into a temp file so the shell wrapper can hand
+ * it back to `worktree work` via `--prompt-file`. Plain stdout markers can't
+ * carry multi-line / shell-special text safely, hence the file.
+ */
+export declare function writePromptFile(prompt: string): string;
 /**
  * The whole `worktree create` flow as a pure function — same code path used
  * by the CLI command and by the dashboard's `w` overlay. Validates input,

package/dist/lib/worktreeCreate.js

@@ -54,7 +54,7 @@ function tryRunInitScript(scriptPath, worktreePath, repoRoot) {
  * it back to `worktree work` via `--prompt-file`. Plain stdout markers can't
  * carry multi-line / shell-special text safely, hence the file.
  */
-function writePromptFile(prompt) {
+export function writePromptFile(prompt) {
     const fileName = `mintree-prompt-${process.pid}-${Date.now()}.txt`;
     const filePath = path.join(os.tmpdir(), fileName);
     fs.writeFileSync(filePath, prompt);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mintree",
-	"version": "0.4.9",
+	"version": "0.5.0",
 	"description": "Issue-driven git worktrees + Claude Code sessions for repos with an opinionated SDD+TDD flow.",
 	"license": "MIT",
 	"author": "Martin Mineo <mmineo@canarytechnologies.com>",

package/shell/init.bash

@@ -43,14 +43,28 @@ function mintree() {
         fi
         cd "$target_dir" && echo "Switched to: $target_dir"
 
+        local perm_mode
+        perm_mode=$(echo "$clean_output" | grep "MINTREE_PERMISSION_MODE:" | sed 's/.*MINTREE_PERMISSION_MODE://')
+
+        # Orchestrate: launch a Claude orchestrator in the repo root (already
+        # cd'd above) with the batch prompt. Takes precedence over WORK — the
+        # two markers are never emitted together.
+        if [[ "$clean_output" == *MINTREE_ORCHESTRATE:* ]]; then
+            local extra=()
+            local orch_prompt_file
+            orch_prompt_file=$(echo "$clean_output" | grep "MINTREE_ORCHESTRATE_PROMPT_FILE:" | sed 's/.*MINTREE_ORCHESTRATE_PROMPT_FILE://')
+            [[ -n "$orch_prompt_file" ]] && extra+=(--prompt-file "$orch_prompt_file")
+            [[ -n "$perm_mode" ]] && extra+=(--permission-mode "$perm_mode")
+            command mintree orchestrate "${extra[@]}"
+            return $?
+        fi
+
         if [[ "$clean_output" != *MINTREE_WORK:* ]]; then
             return 0
         fi
         local extra=()
         local prompt_file
         prompt_file=$(echo "$clean_output" | grep "MINTREE_WORK_PROMPT_FILE:" | sed 's/.*MINTREE_WORK_PROMPT_FILE://')
-        local perm_mode
-        perm_mode=$(echo "$clean_output" | grep "MINTREE_PERMISSION_MODE:" | sed 's/.*MINTREE_PERMISSION_MODE://')
         [[ -n "$prompt_file" ]] && extra+=(--prompt-file "$prompt_file")
         [[ -n "$perm_mode" ]] && extra+=(--permission-mode "$perm_mode")
         command mintree worktree work "${extra[@]}"
@@ -63,7 +77,7 @@ function mintree() {
         local exit_code=$?
 
         if [[ "$output" == *MINTREE_CD:* ]]; then
-            echo "$output" | grep -vE "MINTREE_(CD|WORK|WORK_PROMPT_FILE|PERMISSION_MODE):"
+            echo "$output" | grep -vE "MINTREE_(CD|WORK|WORK_PROMPT_FILE|PERMISSION_MODE|ORCHESTRATE|ORCHESTRATE_PROMPT_FILE):"
             local clean_output=$(echo "$output" | sed 's/\x1b\[[0-9;]*m//g')
             _mintree_handle_markers "$clean_output"
         else

package/shell/init.zsh

@@ -53,14 +53,28 @@ function mintree() {
         fi
         cd "$target_dir" && echo "Switched to: $target_dir"
 
+        local perm_mode
+        perm_mode=$(echo "$clean_output" | grep "MINTREE_PERMISSION_MODE:" | sed 's/.*MINTREE_PERMISSION_MODE://')
+
+        # Orchestrate: launch a Claude orchestrator in the repo root (already
+        # cd'd above) with the batch prompt. Takes precedence over WORK — the
+        # two markers are never emitted together.
+        if [[ "$clean_output" == *MINTREE_ORCHESTRATE:* ]]; then
+            local extra=()
+            local orch_prompt_file
+            orch_prompt_file=$(echo "$clean_output" | grep "MINTREE_ORCHESTRATE_PROMPT_FILE:" | sed 's/.*MINTREE_ORCHESTRATE_PROMPT_FILE://')
+            [[ -n "$orch_prompt_file" ]] && extra+=(--prompt-file "$orch_prompt_file")
+            [[ -n "$perm_mode" ]] && extra+=(--permission-mode "$perm_mode")
+            command mintree orchestrate "${extra[@]}"
+            return $?
+        fi
+
         if [[ "$clean_output" != *MINTREE_WORK:* ]]; then
             return 0
         fi
         local extra=()
         local prompt_file
         prompt_file=$(echo "$clean_output" | grep "MINTREE_WORK_PROMPT_FILE:" | sed 's/.*MINTREE_WORK_PROMPT_FILE://')
-        local perm_mode
-        perm_mode=$(echo "$clean_output" | grep "MINTREE_PERMISSION_MODE:" | sed 's/.*MINTREE_PERMISSION_MODE://')
         [[ -n "$prompt_file" ]] && extra+=(--prompt-file "$prompt_file")
         [[ -n "$perm_mode" ]] && extra+=(--permission-mode "$perm_mode")
         command mintree worktree work "${extra[@]}"
@@ -75,7 +89,7 @@ function mintree() {
         local exit_code=$?
 
         if [[ "$output" == *MINTREE_CD:* ]]; then
-            echo "$output" | grep -vE "MINTREE_(CD|WORK|WORK_PROMPT_FILE|PERMISSION_MODE):"
+            echo "$output" | grep -vE "MINTREE_(CD|WORK|WORK_PROMPT_FILE|PERMISSION_MODE|ORCHESTRATE|ORCHESTRATE_PROMPT_FILE):"
             local clean_output=$(echo "$output" | sed 's/\x1b\[[0-9;]*m//g')
             _mintree_handle_markers "$clean_output"
         else