santree 0.5.3 → 0.5.5

package/dist/commands/{linear → issue}/open.js

@@ -4,11 +4,11 @@ import { Text, Box } from "ink";
 import Spinner from "ink-spinner";
 import { exec } from "child_process";
 import { promisify } from "util";
-import { findMainRepoRoot, getCurrentBranch, extractTicketId } from "../../lib/git.js";
-import { getTicketContent } from "../../lib/linear.js";
+import { findMainRepoRoot, getCurrentBranch } from "../../lib/git.js";
+import { getIssueTracker } from "../../lib/trackers/index.js";
 const execAsync = promisify(exec);
-export const description = "Open the current Linear ticket in the browser";
-export default function LinearOpen() {
+export const description = "Open the current branch's issue in the browser";
+export default function IssueOpen() {
     const [status, setStatus] = useState("checking");
     const [message, setMessage] = useState("");
     useEffect(() => {
@@ -26,16 +26,18 @@ export default function LinearOpen() {
                 setMessage("Could not determine current branch");
                 return;
             }
-            const ticketId = extractTicketId(branch);
+            const tracker = getIssueTracker(repoRoot);
+            const ticketId = tracker.extractIdFromBranch(branch);
             if (!ticketId) {
                 setStatus("error");
-                setMessage("No ticket ID found in branch name (expected pattern like TEAM-123)");
+                setMessage(`No ${tracker.issueNoun} ID found in branch '${branch}'`);
                 return;
             }
-            const issue = await getTicketContent(ticketId, repoRoot);
-            if (!issue?.url) {
+            const result = await tracker.getIssue(ticketId, repoRoot);
+            if (!result.ok || !result.value.url) {
+                const auth = await tracker.getAuthStatus(repoRoot);
                 setStatus("error");
-                setMessage(`Could not fetch ticket ${ticketId}. Check auth with: santree linear auth --status`);
+                setMessage(`Could not fetch ${tracker.issueNoun} ${ticketId}.${auth.hint ? ` ${auth.hint}` : ""}`);
                 return;
             }
             try {
@@ -44,7 +46,7 @@ export default function LinearOpen() {
                     : process.platform === "win32"
                         ? "start"
                         : "xdg-open";
-                await execAsync(`${openCmd} "${issue.url}"`);
+                await execAsync(`${openCmd} "${result.value.url}"`);
                 setStatus("done");
                 setMessage(`Opened ${ticketId} in browser`);
             }
@@ -61,5 +63,5 @@ export default function LinearOpen() {
             return () => clearTimeout(timer);
         }
     }, [status]);
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [status === "checking" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Opening Linear ticket..." })] })), status === "done" && (_jsxs(Text, { color: "green", bold: true, children: ["\u2713 ", message] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", message] }))] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [status === "checking" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Opening issue..." })] })), status === "done" && (_jsxs(Text, { color: "green", bold: true, children: ["\u2713 ", message] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", message] }))] }));
 }

package/dist/commands/issue/switch.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod/v4";
+export declare const description = "Switch the active issue tracker for this repo";
+export declare const args: z.ZodTuple<[z.ZodEnum<{
+    linear: "linear";
+    github: "github";
+}>], null>;
+type Props = {
+    args: z.infer<typeof args>;
+};
+export default function IssueSwitch({ args }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/commands/issue/switch.js

@@ -0,0 +1,38 @@
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Text, Box } from "ink";
+import { argument } from "pastel";
+import { z } from "zod/v4";
+import { findMainRepoRoot } from "../../lib/git.js";
+import { setRepoTracker, getIssueTracker } from "../../lib/trackers/index.js";
+export const description = "Switch the active issue tracker for this repo";
+export const args = z.tuple([
+    z.enum(["linear", "github"]).describe(argument({
+        name: "kind",
+        description: "Tracker kind: linear or github",
+    })),
+]);
+export default function IssueSwitch({ args }) {
+    const [kind] = args;
+    const [status, setStatus] = useState("switching");
+    const [message, setMessage] = useState("");
+    useEffect(() => {
+        const repoRoot = findMainRepoRoot();
+        if (!repoRoot) {
+            setMessage("Not inside a git repository");
+            setStatus("error");
+            return;
+        }
+        setRepoTracker(repoRoot, kind);
+        const tracker = getIssueTracker(repoRoot);
+        setMessage(`Active tracker for this repo: ${tracker.displayName}`);
+        setStatus("done");
+    }, [kind]);
+    useEffect(() => {
+        if (status === "done" || status === "error") {
+            const timer = setTimeout(() => process.exit(status === "error" ? 1 : 0), 50);
+            return () => clearTimeout(timer);
+        }
+    }, [status]);
+    return (_jsxs(Box, { padding: 1, children: [status === "done" && (_jsxs(Text, { color: "green", bold: true, children: ["\u2713 ", message] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", message] }))] }));
+}

package/dist/commands/linear/auth.js

@@ -3,8 +3,10 @@ import { useEffect, useState } from "react";
 import { Text, Box, useInput } from "ink";
 import Spinner from "ink-spinner";
 import { z } from "zod";
-import { findMainRepoRoot, setRepoLinearOrg, getRepoLinearOrg, removeRepoLinearOrg, } from "../../lib/git.js";
-import { startOAuthFlow, getAuthStatus, getValidTokens, getTicketContent, readAuthStore, } from "../../lib/linear.js";
+import { findMainRepoRoot } from "../../lib/git.js";
+import { setRepoLinearOrg, getRepoLinearOrg, removeRepoLinearOrg, startOAuthFlow, getValidTokens, linearTracker, } from "../../lib/trackers/linear/index.js";
+import { readLinearAuthStore } from "../../lib/trackers/auth-store.js";
+import { setRepoTracker } from "../../lib/trackers/index.js";
 import { renderTicket } from "../../lib/prompts.js";
 export const description = "Authenticate with Linear";
 export const options = z.object({
@@ -46,6 +48,7 @@ export default function LinearAuth({ options }) {
                     return;
                 }
                 setRepoLinearOrg(repoRoot, result.orgSlug);
+                setRepoTracker(repoRoot, "linear");
                 setMessage(`Authenticated as ${result.orgName} (${result.orgSlug})`);
                 setStatus("done");
             });
@@ -54,6 +57,7 @@ export default function LinearAuth({ options }) {
         // Link existing org
         const choice = choices[selected];
         setRepoLinearOrg(repoRoot, choice.slug);
+        setRepoTracker(repoRoot, "linear");
         setMessage(`Linked repo to ${choice.name} (${choice.slug})`);
         setStatus("done");
     }
@@ -67,35 +71,42 @@ export default function LinearAuth({ options }) {
                     setStatus("error");
                     return;
                 }
-                const issue = await getTicketContent(options.test, repoRoot);
-                if (!issue) {
+                const result = await linearTracker.getIssue(options.test, repoRoot);
+                if (!result.ok) {
                     setError(`Could not fetch ticket ${options.test}. Check auth and ticket ID.`);
                     setStatus("error");
                     return;
                 }
-                setMessage(renderTicket(issue).trim());
+                setMessage(renderTicket(result.value, linearTracker.displayName).trim());
                 setStatus("done");
                 return;
             }
             if (options.status) {
                 const repoRoot = findMainRepoRoot();
-                const authStatus = getAuthStatus(repoRoot);
+                const authStatus = await linearTracker.getAuthStatus(repoRoot);
                 if (!authStatus.authenticated) {
                     setMessage("Not authenticated with Linear");
                     setStatus("done");
                     return;
                 }
-                if (authStatus.orgSlug) {
-                    const valid = await getValidTokens(authStatus.orgSlug);
+                const orgSlug = repoRoot ? getRepoLinearOrg(repoRoot) : null;
+                if (orgSlug) {
+                    const valid = await getValidTokens(orgSlug);
                     const expiry = valid
                         ? new Date(valid.expires_at).toLocaleString()
                         : "expired (refresh failed)";
                     setMessage([
-                        `Organization: ${authStatus.orgName} (${authStatus.orgSlug})`,
+                        `Account: ${authStatus.accountLabel ?? orgSlug}`,
                         `Token expires: ${expiry}`,
                         `Repo linked: ${authStatus.repoLinked ? "yes" : "no"}`,
                     ].join("\n"));
                 }
+                else {
+                    setMessage([
+                        `Account: ${authStatus.accountLabel ?? "unknown"}`,
+                        `Repo linked: ${authStatus.repoLinked ? "yes" : "no"}`,
+                    ].join("\n"));
+                }
                 setStatus("done");
                 return;
             }
@@ -142,12 +153,13 @@ export default function LinearAuth({ options }) {
                     return;
                 }
                 setRepoLinearOrg(repoRoot, result.orgSlug);
+                setRepoTracker(repoRoot, "linear");
                 setMessage(`Re-authenticated as ${result.orgName} (${result.orgSlug})`);
                 setStatus("done");
                 return;
             }
             // Check for existing authenticated orgs
-            const store = readAuthStore();
+            const store = readLinearAuthStore();
             const orgs = Object.entries(store).map(([slug, tokens]) => ({
                 slug,
                 name: tokens.org_name,
@@ -162,6 +174,7 @@ export default function LinearAuth({ options }) {
                     return;
                 }
                 setRepoLinearOrg(repoRoot, result.orgSlug);
+                setRepoTracker(repoRoot, "linear");
                 setMessage(`Authenticated as ${result.orgName} (${result.orgSlug})`);
                 setStatus("done");
                 return;

package/dist/commands/linear/switch.js

@@ -2,8 +2,10 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 import { Text, Box, useInput } from "ink";
 import Spinner from "ink-spinner";
-import { findMainRepoRoot, setRepoLinearOrg, getRepoLinearOrg } from "../../lib/git.js";
-import { readAuthStore } from "../../lib/linear.js";
+import { findMainRepoRoot } from "../../lib/git.js";
+import { setRepoLinearOrg, getRepoLinearOrg } from "../../lib/trackers/linear/index.js";
+import { readLinearAuthStore } from "../../lib/trackers/auth-store.js";
+import { setRepoTracker } from "../../lib/trackers/index.js";
 export const description = "Switch Linear workspace for this repo";
 export default function LinearSwitch() {
     const [status, setStatus] = useState("checking");
@@ -25,6 +27,7 @@ export default function LinearSwitch() {
             const choice = choices[selected];
             const repoRoot = findMainRepoRoot();
             setRepoLinearOrg(repoRoot, choice.slug);
+            setRepoTracker(repoRoot, "linear");
             setMessage(`Switched to ${choice.name} (${choice.slug})`);
             setStatus("done");
         }
@@ -38,7 +41,7 @@ export default function LinearSwitch() {
                 setStatus("error");
                 return;
             }
-            const store = readAuthStore();
+            const store = readLinearAuthStore();
             const orgs = Object.entries(store).map(([slug, tokens]) => ({
                 slug,
                 name: tokens.org_name,
@@ -51,6 +54,7 @@ export default function LinearSwitch() {
             if (orgs.length === 1) {
                 const org = orgs[0];
                 setRepoLinearOrg(repoRoot, org.slug);
+                setRepoTracker(repoRoot, "linear");
                 setMessage(`Linked to ${org.name} (${org.slug})`);
                 setStatus("done");
                 return;

package/dist/commands/pr/create.js

@@ -12,7 +12,7 @@ import { findMainRepoRoot, findRepoRoot, getCurrentBranch, getBaseBranch, hasUnc
 import { ghCliAvailable, getPRInfoAsync, pushBranch, createPR, getPRTemplate, } from "../../lib/github.js";
 import { renderPrompt, renderDiff, renderTicket } from "../../lib/prompts.js";
 import { runAgent } from "../../lib/ai.js";
-import { getTicketContent } from "../../lib/linear.js";
+import { getIssueTracker } from "../../lib/trackers/index.js";
 const execAsync = promisify(exec);
 export const description = "Create a GitHub pull request";
 export const options = z.object({
@@ -63,12 +63,14 @@ export default function PR({ options }) {
             }
             const ticketId = extractTicketId(branch);
             const mainRepoRoot = findMainRepoRoot();
-            // Fetch ticket content (downloads images for Linear tickets)
+            // Fetch issue content from the active tracker (downloads images
+            // inline so Claude can read them via --allowedTools Read).
             let ticketContent;
             if (ticketId && mainRepoRoot) {
-                const ticket = await getTicketContent(ticketId, mainRepoRoot);
-                if (ticket) {
-                    ticketContent = renderTicket(ticket);
+                const tracker = getIssueTracker(mainRepoRoot);
+                const result = await tracker.getIssue(ticketId, mainRepoRoot);
+                if (result.ok) {
+                    ticketContent = renderTicket(result.value, tracker.displayName);
                 }
             }
             const diffContent = renderDiff({

package/dist/commands/worktree/create.js

@@ -36,7 +36,6 @@ export default function Create({ options, args }) {
     const [worktreePath, setWorktreePath] = useState("");
     const [baseBranch, setBaseBranch] = useState(null);
     const [muxWindowName, setMuxWindowName] = useState(null);
-    const [muxKind, setMuxKind] = useState(null);
     async function finalize(path, branch) {
         const wantsWindow = options.window || options.tmux;
         if (wantsWindow) {
@@ -48,24 +47,23 @@ export default function Create({ options, args }) {
                 return;
             }
             setStatus("spawning-window");
-            setMessage(`Creating ${mux.kind} window...`);
+            setMessage("Creating window...");
             const windowName = getWindowName(branch, options.name);
             setMuxWindowName(windowName);
-            setMuxKind(mux.kind);
             let runCommand;
             if (options.work) {
                 runCommand = options.plan ? "st worktree work --plan" : "st worktree work";
             }
             const result = await mux.createWindow({ name: windowName, cwd: path, command: runCommand });
             if (!result.ok) {
-                setMessage(`Worktree created, but failed to create ${mux.kind} window${result.message ? `: ${result.message}` : ""}`);
+                setMessage(`Worktree created, but failed to create window${result.message ? `: ${result.message}` : ""}`);
                 setStatus("done");
                 console.log(`SANTREE_CD:${path}`);
                 return;
             }
             setStatus("done");
             const workInfo = options.work ? (options.plan ? " + Claude (plan)" : " + Claude") : "";
-            setMessage(`Worktree and ${mux.kind} window created!${workInfo}`);
+            setMessage(`Worktree and window created!${workInfo}`);
             // Don't output SANTREE_CD when a window is created — user is already in the new window
             return;
         }
@@ -161,5 +159,5 @@ export default function Create({ options, args }) {
         status === "creating" ||
         status === "init-script" ||
         status === "spawning-window";
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\uD83C\uDF31 Create Worktree" }) }), branchName && (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: status === "error" ? "red" : status === "done" ? "green" : "blue", paddingX: 1, width: "100%", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "branch:" }), _jsx(Text, { color: "cyan", bold: true, children: branchName })] }), baseBranch && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "base:" }), _jsx(Text, { color: "blue", children: baseBranch })] })), options["no-pull"] && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "skip pull:" }), _jsx(Text, { color: "yellow", children: "yes" })] })), options.work && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "after:" }), _jsx(Text, { backgroundColor: "magenta", color: "white", children: options.plan ? " plan " : " work " })] })), (options.window || options.tmux) && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "window:" }), _jsx(Text, { backgroundColor: "green", color: "white", children: ` ${options.name || "auto"} ` })] }))] })), _jsxs(Box, { marginTop: 1, children: [isLoading && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", message] })] })), status === "done" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "green", bold: true, children: ["\u2713 ", message] }), _jsxs(Text, { dimColor: true, children: [" ", worktreePath] }), muxWindowName && (_jsxs(Text, { dimColor: true, children: [" ", muxKind ?? "tmux", " window: ", muxWindowName] }))] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", message] }))] })] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\uD83C\uDF31 Create Worktree" }) }), branchName && (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: status === "error" ? "red" : status === "done" ? "green" : "blue", paddingX: 1, width: "100%", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "branch:" }), _jsx(Text, { color: "cyan", bold: true, children: branchName })] }), baseBranch && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "base:" }), _jsx(Text, { color: "blue", children: baseBranch })] })), options["no-pull"] && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "skip pull:" }), _jsx(Text, { color: "yellow", children: "yes" })] })), options.work && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "after:" }), _jsx(Text, { backgroundColor: "magenta", color: "white", children: options.plan ? " plan " : " work " })] })), (options.window || options.tmux) && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "window:" }), _jsx(Text, { backgroundColor: "green", color: "white", children: ` ${options.name || "auto"} ` })] }))] })), _jsxs(Box, { marginTop: 1, children: [isLoading && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", message] })] })), status === "done" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "green", bold: true, children: ["\u2713 ", message] }), _jsxs(Text, { dimColor: true, children: [" ", worktreePath] }), muxWindowName && _jsxs(Text, { dimColor: true, children: [" window: ", muxWindowName] })] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", message] }))] })] }));
 }

package/dist/commands/worktree/work.js

@@ -99,5 +99,5 @@ export default function Work({ options }) {
             setError(err instanceof Error ? err.message : "Failed to launch agent");
         }
     }, [status, aiContext, mode]);
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "Work" }) }), _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: status === "error" ? "red" : getModeColor(mode), paddingX: 1, width: "100%", children: [branch && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "branch:" }), _jsx(Text, { color: "cyan", bold: true, children: branch })] })), ticketId && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "ticket:" }), _jsx(Text, { color: "blue", bold: true, children: ticketId })] })), _jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "mode:" }), _jsx(Text, { backgroundColor: getModeColor(mode), color: "white", bold: true, children: ` ${getModeLabel(mode)} ` })] })] }), _jsxs(Box, { marginTop: 1, children: [status === "loading" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Loading..." })] })), status === "fetching" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Fetching ticket from Linear..." })] })), status === "launching" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "green", bold: true, children: "\u2713 Launching Claude..." }), _jsxs(Text, { dimColor: true, children: [" ", "claude", mode === "plan" ? " --permission-mode plan" : "", " ", `"<${getModeLabel(mode)} prompt for ${ticketId}>"`] })] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", error] }))] })] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "Work" }) }), _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: status === "error" ? "red" : getModeColor(mode), paddingX: 1, width: "100%", children: [branch && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "branch:" }), _jsx(Text, { color: "cyan", bold: true, children: branch })] })), ticketId && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "ticket:" }), _jsx(Text, { color: "blue", bold: true, children: ticketId })] })), _jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "mode:" }), _jsx(Text, { backgroundColor: getModeColor(mode), color: "white", bold: true, children: ` ${getModeLabel(mode)} ` })] })] }), _jsxs(Box, { marginTop: 1, children: [status === "loading" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Loading..." })] })), status === "fetching" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Fetching issue from tracker..." })] })), status === "launching" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "green", bold: true, children: "\u2713 Launching Claude..." }), _jsxs(Text, { dimColor: true, children: [" ", "claude", mode === "plan" ? " --permission-mode plan" : "", " ", `"<${getModeLabel(mode)} prompt for ${ticketId}>"`] })] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", error] }))] })] }));
 }

package/dist/lib/ai.d.ts

@@ -1,15 +1,17 @@
 import { type ChildProcess } from "child_process";
-import { cleanupImages, type LinearIssue } from "./linear.js";
+import type { Issue } from "./trackers/types.js";
 export interface AIContext {
     repoRoot: string;
     mainRoot: string;
     branch: string;
     ticketId: string | null;
-    ticket: LinearIssue | null;
+    ticket: Issue | null;
+    trackerName: string;
+    issueNoun: string;
 }
 /**
- * Resolves repo, branch, ticket ID, and fetches the Linear ticket.
- * Returns an error string if any required context is missing.
+ * Resolves repo, branch, issue identifier, and fetches the issue from the
+ * active tracker (Linear or GitHub Issues — selected by repo config).
  */
 export declare function resolveAIContext(): Promise<{
     ok: true;
@@ -74,6 +76,6 @@ export declare function runAgent(prompt: string, opts?: {
     allowedTools?: string[];
 }): RunAgentResult;
 /**
- * Cleanup images downloaded for a ticket.
+ * Clean up cached image downloads for an issue identifier on the active tracker.
  */
-export { cleanupImages };
+export declare function cleanupImages(ticketId: string): void;

package/dist/lib/ai.js

@@ -2,15 +2,14 @@ import { execSync, spawn, spawnSync } from "child_process";
 import { existsSync, writeFileSync } from "fs";
 import { join } from "path";
 import { homedir, tmpdir } from "os";
-import { getMultiplexer } from "./multiplexer/index.js";
-import { getCurrentBranch, extractTicketId, findRepoRoot, findMainRepoRoot, getBaseBranch, } from "./git.js";
+import { getCurrentBranch, findRepoRoot, findMainRepoRoot, getBaseBranch } from "./git.js";
 import { renderPrompt, renderTicket, renderDiff, renderPR } from "./prompts.js";
-import { getTicketContent, cleanupImages } from "./linear.js";
+import { getIssueTracker } from "./trackers/index.js";
 import { getPRInfoAsync, getPRChecksAsync, getPRReviewsAsync, getPRReviewCommentsAsync, getPRConversationCommentsAsync, getFailedCheckDetailsAsync, } from "./github.js";
 import { runAsync } from "./exec.js";
 /**
- * Resolves repo, branch, ticket ID, and fetches the Linear ticket.
- * Returns an error string if any required context is missing.
+ * Resolves repo, branch, issue identifier, and fetches the issue from the
+ * active tracker (Linear or GitHub Issues — selected by repo config).
  */
 export async function resolveAIContext() {
     const repoRoot = findRepoRoot();
@@ -21,18 +20,28 @@ export async function resolveAIContext() {
     if (!branch) {
         return { ok: false, error: "Could not determine current branch" };
     }
-    const ticketId = extractTicketId(branch);
+    const mainRoot = findMainRepoRoot() ?? repoRoot;
+    const tracker = getIssueTracker(mainRoot);
+    const ticketId = tracker.extractIdFromBranch(branch);
     if (!ticketId) {
         return {
             ok: false,
-            error: "Could not extract ticket ID from branch name. Expected format: user/TEAM-123-description",
+            error: `Could not extract ${tracker.issueNoun} ID from branch name '${branch}'.`,
         };
     }
-    const mainRoot = findMainRepoRoot() ?? repoRoot;
-    const ticket = await getTicketContent(ticketId, mainRoot);
+    const result = await tracker.getIssue(ticketId, mainRoot);
+    const ticket = result.ok ? result.value : null;
     return {
         ok: true,
-        context: { repoRoot, mainRoot, branch, ticketId, ticket },
+        context: {
+            repoRoot,
+            mainRoot,
+            branch,
+            ticketId,
+            ticket,
+            trackerName: tracker.displayName,
+            issueNoun: tracker.issueNoun,
+        },
     };
 }
 /**
@@ -41,7 +50,7 @@ export async function resolveAIContext() {
 export function buildPromptContext(ctx, extra) {
     return {
         ticket_id: ctx.ticketId ?? undefined,
-        ticket_content: ctx.ticket ? renderTicket(ctx.ticket) : undefined,
+        ticket_content: ctx.ticket ? renderTicket(ctx.ticket, ctx.trackerName) : undefined,
         ...extra,
     };
 }
@@ -122,8 +131,10 @@ const CMUX_CLAUDE_PATH = "/Applications/cmux.app/Contents/Resources/bin/claude";
  */
 export function resolveClaudeBinary() {
     // Inside cmux, the bundled binary is the only one wired to the active
-    // workspace. Always prefer it when present.
-    if (getMultiplexer().kind === "cmux" && existsSync(CMUX_CLAUDE_PATH)) {
+    // workspace. Gate on `CMUX_SURFACE_ID` (real cmux runtime) — outside a live
+    // workspace the bundled binary has no auth context and exits with
+    // "Invalid API key".
+    if (process.env["CMUX_SURFACE_ID"] && existsSync(CMUX_CLAUDE_PATH)) {
         return CMUX_CLAUDE_PATH;
     }
     // PATH lookup
@@ -216,6 +227,9 @@ export function runAgent(prompt, opts) {
     };
 }
 /**
- * Cleanup images downloaded for a ticket.
+ * Clean up cached image downloads for an issue identifier on the active tracker.
  */
-export { cleanupImages };
+export function cleanupImages(ticketId) {
+    const repoRoot = findMainRepoRoot();
+    getIssueTracker(repoRoot).cleanupCache(ticketId);
+}

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

@@ -14,7 +14,10 @@ export type IssueActionItem = {
 };
 /** Returns the context-sensitive action key list for the selected issue.
  * Lifted out of the panel so the dashboard can render it on the same row as
- * the global command bar (so left- and right-pane key hints align). */
-export declare function buildIssueActions(di: DashboardIssue): IssueActionItem[];
+ * the global command bar (so left- and right-pane key hints align). The
+ * `trackerName` is the active tracker's `displayName` ("Linear" / "GitHub"),
+ * surfaced as the open-in-browser action label so the panel doesn't hardcode
+ * a vendor name. */
+export declare function buildIssueActions(di: DashboardIssue, trackerName: string): IssueActionItem[];
 export default function DetailPanel({ issue, scrollOffset, height, width, creatingForTicket, creationLogs, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/lib/dashboard/DetailPanel.js

@@ -51,8 +51,11 @@ function fileColor(xy) {
 }
 /** Returns the context-sensitive action key list for the selected issue.
  * Lifted out of the panel so the dashboard can render it on the same row as
- * the global command bar (so left- and right-pane key hints align). */
-export function buildIssueActions(di) {
+ * the global command bar (so left- and right-pane key hints align). The
+ * `trackerName` is the active tracker's `displayName` ("Linear" / "GitHub"),
+ * surfaced as the open-in-browser action label so the panel doesn't hardcode
+ * a vendor name. */
+export function buildIssueActions(di, trackerName) {
     const { worktree, pr, issue } = di;
     const items = [];
     if (worktree?.sessionId) {
@@ -82,7 +85,7 @@ export function buildIssueActions(di) {
         items.push({ key: "r", label: "Review", color: "cyan" });
     }
     if (issue.url) {
-        items.push({ key: "o", label: "Linear", color: "gray" });
+        items.push({ key: "o", label: trackerName, color: "gray" });
     }
     if (pr)
         items.push({ key: "p", label: "Open PR", color: "gray" });

package/dist/lib/dashboard/data.js

@@ -1,14 +1,18 @@
 import { listWorktrees, extractTicketId, getBaseBranch, readAllMetadata, readSessionState, isSessionAlive, clearSessionState, getGitStatusAsync, getCommitsAheadAsync, getDiffShortstatAsync, } from "../git.js";
 import { getPRInfoAsync, getPRChecksAsync, getPRReviewsAsync, getPRConversationCommentsAsync, getPRViewAsync, getReviewRequestedPRsAsync, getRepoNameAsync, } from "../github.js";
-import { fetchAssignedIssues } from "../linear.js";
+import { getIssueTracker } from "../trackers/index.js";
 export async function loadDashboardData(repoRoot) {
     // Fetch issues and worktrees in parallel
-    const [issues, worktrees] = await Promise.all([
-        fetchAssignedIssues(repoRoot),
+    const tracker = getIssueTracker(repoRoot);
+    const [listResult, worktrees] = await Promise.all([
+        tracker.listAssigned(repoRoot),
         Promise.resolve(listWorktrees()),
     ]);
-    if (!issues)
-        throw new Error("Failed to authenticate with Linear. Run: santree linear auth");
+    if (!listResult.ok) {
+        const status = await tracker.getAuthStatus(repoRoot);
+        throw new Error(listResult.message ?? status.hint ?? `Failed to authenticate with ${tracker.displayName}`);
+    }
+    const issues = listResult.value;
     // Build worktree map: ticketId -> worktree info
     const wtMap = new Map();
     for (const wt of worktrees) {
@@ -92,10 +96,14 @@ export async function loadDashboardData(repoRoot) {
                 getPRReviewsAsync(pr.number),
             ]);
         }
-        // Derive a readable title from branch name: strip prefix and ticket ID
-        const titleFromBranch = wt.branch
-            .replace(/^[^/]+\//, "") // strip prefix (e.g. "feature/")
-            .replace(/^[A-Z]+-\d+-?/, "") // strip ticket ID
+        // Derive a readable title from branch name: strip prefix and the
+        // tracker-format ID literal (e.g. "TEAM-123-" or "123-"). The ID
+        // shape comes from the tracker's parser so this works for both
+        // Linear and GitHub branches.
+        const idLiteral = tid ? new RegExp(`^${tid}-?`) : null;
+        const titleFromBranch = (idLiteral
+            ? wt.branch.replace(/^[^/]+\//, "").replace(idLiteral, "")
+            : wt.branch.replace(/^[^/]+\//, ""))
             .replace(/-/g, " ")
             .trim() || tid;
         let sessState = readSessionState(repoRoot, tid);

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

@@ -1,19 +1,6 @@
 import type { PRInfo, PRCheck, PRReview, PRConversationComment, SearchPR } from "../github.js";
-export interface LinearAssignedIssue {
-    identifier: string;
-    title: string;
-    description: string | null;
-    url: string;
-    priority: number;
-    priorityLabel: string;
-    state: {
-        name: string;
-        type: string;
-    };
-    labels: string[];
-    projectId: string | null;
-    projectName: string | null;
-}
+import type { AssignedIssue } from "../trackers/types.js";
+export type { AssignedIssue } from "../trackers/types.js";
 export interface WorktreeInfo {
     path: string;
     branch: string;
@@ -30,7 +17,7 @@ export interface WorktreeInfo {
     } | null;
 }
 export interface DashboardIssue {
-    issue: LinearAssignedIssue;
+    issue: AssignedIssue;
     worktree: WorktreeInfo | null;
     pr: PRInfo | null;
     checks: PRCheck[] | null;

package/dist/lib/english-tutor.d.ts

@@ -0,0 +1,13 @@
+export declare function getLogPath(): string;
+export declare function getHooksJson(): Record<string, unknown>;
+export declare function getPermissionEntry(): string;
+export declare function installHooks(): {
+    settingsPath: string;
+    logPath: string;
+};
+/**
+ * Remove hooks and permission entry. Intentionally does NOT delete the log
+ * file — that's the user's accumulated practice history.
+ */
+export declare function uninstallHooks(): string;
+export declare function getInstallSnippet(): Record<string, unknown>;