santree 0.5.3 → 0.5.4

package/dist/commands/doctor.js

@@ -10,7 +10,7 @@ import * as path from "path";
 const require = createRequire(import.meta.url);
 const { version } = require("../../package.json");
 import { findMainRepoRoot, getSantreeDir, getInitScriptPath } from "../lib/git.js";
-import { getAuthStatus, getValidTokens } from "../lib/linear.js";
+import { getIssueTracker } from "../lib/trackers/index.js";
 import { getMultiplexer } from "../lib/multiplexer/index.js";
 import { resolveClaudeBinary } from "../lib/ai.js";
 import { CURRENT_VERSION, CLAUDE_CODE_PACKAGE, SANTREE_PACKAGE, getLatestVersionFor, isUpdateAvailable, detectPackageManager, getInstallCommandFor, } from "../lib/version.js";
@@ -135,8 +135,9 @@ async function checkMultiplexer() {
  */
 async function checkClaude() {
     const resolved = resolveClaudeBinary();
+    const usingBundled = resolved?.startsWith("/Applications/cmux.app/") ?? false;
     const inCmux = getMultiplexer().kind === "cmux";
-    const description = inCmux ? "Claude Code CLI (cmux-bundled)" : "Claude Code CLI";
+    const description = usingBundled ? "Claude Code CLI (cmux-bundled)" : "Claude Code CLI";
     if (!resolved) {
         return {
             name: "claude",
@@ -197,30 +198,22 @@ async function checkGhAuth() {
     };
 }
 /**
- * Checks Linear API authentication status.
+ * Checks the active issue tracker's auth state. The tracker (Linear, GitHub)
+ * is resolved from the repo's `_tracker` config (or env / auto-detect).
+ * Doctor is the one place that legitimately names the active tracker — it's
+ * diagnostic context, not a generic UI string.
  */
-async function checkLinearAuth() {
+async function checkTrackerAuth() {
     const repoRoot = findMainRepoRoot();
-    const status = getAuthStatus(repoRoot);
-    if (!status.authenticated || !status.orgSlug) {
-        return {
-            authenticated: false,
-            hint: "Run: santree linear auth",
-        };
-    }
-    // Try to validate/refresh tokens
-    const valid = await getValidTokens(status.orgSlug);
+    const tracker = getIssueTracker(repoRoot);
+    const status = await tracker.getAuthStatus(repoRoot);
     return {
-        authenticated: true,
-        orgSlug: status.orgSlug,
-        orgName: status.orgName,
-        tokenValid: valid !== null,
+        displayName: tracker.displayName,
+        authenticated: status.authenticated,
+        accountLabel: status.accountLabel,
+        expiresAt: status.expiresAt,
         repoLinked: status.repoLinked,
-        hint: !valid
-            ? "Token expired. Run: santree linear auth"
-            : !status.repoLinked
-                ? "Repo not linked. Run: santree linear auth"
-                : undefined,
+        hint: status.hint,
     };
 }
 /**
@@ -334,39 +327,12 @@ function checkSessionSignalHooks() {
     catch {
         missingHooks.push(...requiredEvents);
     }
-    // Check hook script files in .santree/hooks/
-    const hookScripts = [];
-    const mainRepoRoot = findMainRepoRoot();
-    let hooksDir = null;
-    if (mainRepoRoot) {
-        hooksDir = path.join(mainRepoRoot, ".santree", "hooks");
-        const scriptNames = ["on-waiting.sh", "on-active.sh", "on-idle.sh", "on-exited.sh"];
-        for (const name of scriptNames) {
-            const scriptPath = path.join(hooksDir, name);
-            const exists = fs.existsSync(scriptPath);
-            let executable = false;
-            if (exists) {
-                try {
-                    fs.accessSync(scriptPath, fs.constants.X_OK);
-                    executable = true;
-                }
-                catch {
-                    // not executable
-                }
-            }
-            if (exists) {
-                hookScripts.push({ name, exists, executable });
-            }
-        }
-    }
     if (missingHooks.length === 0) {
-        return { configured: true, missingHooks: [], hookScripts, hooksDir };
+        return { configured: true, missingHooks: [] };
     }
     return {
         configured: false,
         missingHooks,
-        hookScripts,
-        hooksDir,
         hint: `Missing: ${missingHooks.join(", ")}. Run: santree helpers session-signal install`,
     };
 }
@@ -451,9 +417,9 @@ function StatusIcon({ ok, required }) {
 function ToolRow({ tool }) {
     return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: tool.installed && !tool.hint, required: tool.required }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: tool.name }), _jsxs(Text, { dimColor: true, children: [" - ", tool.description] }), !tool.required && _jsx(Text, { dimColor: true, children: " (optional)" })] }), tool.installed ? (_jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["Version: ", tool.version] }), tool.latestVersion && tool.version && (_jsxs(Text, { color: isUpdateAvailable(tool.version, tool.latestVersion) ? "yellow" : undefined, dimColor: !isUpdateAvailable(tool.version, tool.latestVersion), children: ["Latest: ", tool.latestVersion, isUpdateAvailable(tool.version, tool.latestVersion) ? " ⬆ update available" : ""] })), tool.path && _jsxs(Text, { dimColor: true, children: ["Path: ", tool.path] }), tool.authStatus && _jsxs(Text, { dimColor: true, children: ["Auth: ", tool.authStatus] }), tool.updateHint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tool.updateHint] }), tool.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tool.hint] })] })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tool.hint] }) }))] }));
 }
-function LinearRow({ linear }) {
-    const isOk = linear.authenticated && linear.tokenValid && linear.repoLinked;
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: !!isOk, required: true }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Linear API" }), _jsx(Text, { dimColor: true, children: " - Linear ticket integration" })] }), linear.authenticated ? (_jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["Organization: ", linear.orgName, " (", linear.orgSlug, ")"] }), _jsxs(Text, { dimColor: true, children: ["Token: ", linear.tokenValid ? "valid" : "expired"] }), _jsxs(Text, { dimColor: true, children: ["Repo linked: ", linear.repoLinked ? "yes" : "no"] }), linear.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", linear.hint] })] })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", linear.hint] }) }))] }));
+function TrackerRow({ tracker }) {
+    const isOk = tracker.authenticated && !tracker.hint;
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: isOk, required: true }), _jsx(Text, { children: " " }), _jsxs(Text, { bold: true, children: [tracker.displayName, " API"] }), _jsx(Text, { dimColor: true, children: " - Issue tracker integration" })] }), tracker.authenticated ? (_jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [tracker.accountLabel && _jsxs(Text, { dimColor: true, children: ["Account: ", tracker.accountLabel] }), tracker.repoLinked !== undefined && (_jsxs(Text, { dimColor: true, children: ["Repo linked: ", tracker.repoLinked ? "yes" : "no"] })), tracker.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tracker.hint] })] })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tracker.hint] }) }))] }));
 }
 function ShellRow({ configured, shell }) {
     return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: configured, required: true }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Shell Integration" }), _jsx(Text, { dimColor: true, children: " - Enables directory switching" })] }), configured ? (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { dimColor: true, children: ["Shell: ", shell] }) })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 Add to .", shell, "rc: eval \"$(santree helpers shell-init ", shell, ")\""] }) }))] }));
@@ -465,13 +431,7 @@ function RemoteControlRow({ status }) {
     return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: status.enabled, required: false }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Remote Control" }), _jsx(Text, { dimColor: true, children: " - Continue sessions from any device" }), _jsx(Text, { dimColor: true, children: " (optional)" })] }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["Enabled: ", status.enabled ? "yes" : "no"] }), status.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", status.hint] })] })] }));
 }
 function SessionSignalRow({ status }) {
-    const allScriptNames = ["on-waiting.sh", "on-active.sh", "on-idle.sh", "on-exited.sh"];
-    const existingNames = new Set(status.hookScripts.map((s) => s.name));
-    const missingScripts = allScriptNames.filter((n) => !existingNames.has(n));
-    const nonExecutable = status.hookScripts.filter((s) => !s.executable);
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: status.configured && nonExecutable.length === 0, required: false }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Session Signal Hooks" }), _jsx(Text, { dimColor: true, children: " - Surface session state in dashboard/tmux" }), _jsx(Text, { dimColor: true, children: " (optional)" })] }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [status.configured ? (_jsx(Text, { dimColor: true, children: "All hooks configured" })) : (_jsxs(_Fragment, { children: [_jsxs(Text, { dimColor: true, children: ["Missing: ", status.missingHooks.join(", ")] }), status.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", status.hint] })] })), status.hooksDir && (_jsxs(Text, { dimColor: true, children: ["Hook scripts:", " ", status.hookScripts.length > 0
-                                ? status.hookScripts.map((s) => s.name).join(", ")
-                                : "none"] })), status.hooksDir && missingScripts.length > 0 && (_jsxs(Text, { color: "yellow", children: ["\u21B3 Create in ", status.hooksDir, ": ", missingScripts.join(", ")] })), nonExecutable.map((s) => (_jsxs(Text, { color: "yellow", children: ["\u21B3 ", s.name, " is not executable. Run: chmod +x .santree/hooks/", s.name] }, s.name)))] })] }));
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: status.configured, required: false }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Session Signal Hooks" }), _jsx(Text, { dimColor: true, children: " - Surface session state in dashboard/tmux" }), _jsx(Text, { dimColor: true, children: " (optional)" })] }), _jsx(Box, { marginLeft: 2, flexDirection: "column", children: status.configured ? (_jsx(Text, { dimColor: true, children: "All hooks configured" })) : (_jsxs(_Fragment, { children: [_jsxs(Text, { dimColor: true, children: ["Missing: ", status.missingHooks.join(", ")] }), status.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", status.hint] })] })) })] }));
 }
 function SantreeSetupRow({ status }) {
     const isOk = status.santreeFolderExists &&
@@ -490,7 +450,7 @@ function SantreeSetupRow({ status }) {
 }
 export default function Doctor() {
     const [tools, setTools] = useState([]);
-    const [linear, setLinear] = useState(null);
+    const [tracker, setTracker] = useState(null);
     const [shellStatus, setShellStatus] = useState(null);
     const [remoteControl, setRemoteControl] = useState(null);
     const [statusline, setStatusline] = useState(null);
@@ -541,12 +501,14 @@ export default function Doctor() {
                     }
                 }
             }
-            // Optional: a syntax-highlighted diff pager — used by `st worktree diff`
+            // Optional: a syntax-highlighting diff pager — used by `st worktree diff`
             // and the dashboard `v` overlay when SANTREE_DIFF_TOOL is set. Any
-            // pager works (delta, diff-so-fancy, …); without one set, git's
-            // default pager runs. Delta is the most popular choice so we check
-            // for it as a convenience, but it is never a hard dependency.
-            const deltaCheck = await checkTool("delta", "Recommended diff pager — any pager works", false, "delta --version | head -1", "Optional — git's default pager works too. Set SANTREE_DIFF_TOOL or `git config core.pager <tool>`. To install delta: brew install git-delta");
+            // diff pager works (delta, diff-so-fancy, …); without one set, the
+            // dashboard renders inline with santree's own colorizer and the CLI
+            // falls back to git's default pager. Delta is the most popular
+            // choice so we check for it as a convenience, but it is never a
+            // hard dependency.
+            const deltaCheck = await checkTool("delta", "Recommended diff pager — any diff pager works", false, "delta --version | head -1", "Optional — santree's built-in colorizer handles the dashboard overlay; the CLI falls back to git's default pager. Set SANTREE_DIFF_TOOL to override. To install delta: brew install git-delta");
             results.push(deltaCheck);
             // Optional: a `.code-workspace`-aware editor (VSCode or Cursor).
             // Santree itself works with any editor via $SANTREE_EDITOR — this
@@ -573,10 +535,10 @@ export default function Doctor() {
                     hint: "Optional — santree works with any $SANTREE_EDITOR. Only needed for the dashboard's `.code-workspace` shortcut.",
                 });
             }
-            const linearResult = await checkLinearAuth();
+            const trackerResult = await checkTrackerAuth();
             const statuslineResult = await checkStatusline();
             setTools(results);
-            setLinear(linearResult);
+            setTracker(trackerResult);
             setShellStatus(checkShellIntegration());
             setRemoteControl(checkRemoteControl());
             setStatusline(statuslineResult);
@@ -591,7 +553,7 @@ export default function Doctor() {
     }
     const requiredMissing = tools.filter((t) => t.required && (!t.installed || t.hint));
     const optionalMissing = tools.filter((t) => !t.required && !t.installed);
-    const linearOk = linear?.authenticated && linear?.tokenValid && linear?.repoLinked;
-    const allRequired = requiredMissing.length === 0 && linearOk && shellStatus?.configured;
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "Santree Doctor" }), _jsxs(Text, { dimColor: true, children: [" v", version] })] }), _jsx(Box, { marginBottom: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "CLI Tools" }) }), tools.map((tool) => (_jsx(ToolRow, { tool: tool }, tool.name))), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Integrations" }) }), linear && _jsx(LinearRow, { linear: linear }), shellStatus && _jsx(ShellRow, { configured: shellStatus.configured, shell: shellStatus.shell }), santreeSetup && _jsx(SantreeSetupRow, { status: santreeSetup }), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Claude Code" }) }), remoteControl && _jsx(RemoteControlRow, { status: remoteControl }), statusline && _jsx(StatuslineRow, { status: statusline }), sessionSignal && _jsx(SessionSignalRow, { status: sessionSignal }), _jsx(Box, { marginTop: 1, borderStyle: "single", borderColor: allRequired ? "green" : "yellow", paddingX: 2, children: allRequired ? (_jsx(Text, { color: "green", children: "All requirements satisfied! Santree is ready to use." })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "yellow", children: [requiredMissing.length + (linearOk ? 0 : 1) + (shellStatus?.configured ? 0 : 1), " ", "required item(s) need attention"] }), optionalMissing.length > 0 && (_jsxs(Text, { dimColor: true, children: [optionalMissing.length, " optional item(s) not installed"] }))] })) })] }));
+    const trackerOk = tracker?.authenticated && !tracker?.hint;
+    const allRequired = requiredMissing.length === 0 && trackerOk && shellStatus?.configured;
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "Santree Doctor" }), _jsxs(Text, { dimColor: true, children: [" v", version] })] }), _jsx(Box, { marginBottom: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "CLI Tools" }) }), tools.map((tool) => (_jsx(ToolRow, { tool: tool }, tool.name))), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Integrations" }) }), tracker && _jsx(TrackerRow, { tracker: tracker }), shellStatus && _jsx(ShellRow, { configured: shellStatus.configured, shell: shellStatus.shell }), santreeSetup && _jsx(SantreeSetupRow, { status: santreeSetup }), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Claude Code" }) }), remoteControl && _jsx(RemoteControlRow, { status: remoteControl }), statusline && _jsx(StatuslineRow, { status: statusline }), sessionSignal && _jsx(SessionSignalRow, { status: sessionSignal }), _jsx(Box, { marginTop: 1, borderStyle: "single", borderColor: allRequired ? "green" : "yellow", paddingX: 2, children: allRequired ? (_jsx(Text, { color: "green", children: "All requirements satisfied! Santree is ready to use." })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "yellow", children: [requiredMissing.length + (trackerOk ? 0 : 1) + (shellStatus?.configured ? 0 : 1), " ", "required item(s) need attention"] }), optionalMissing.length > 0 && (_jsxs(Text, { dimColor: true, children: [optionalMissing.length, " optional item(s) not installed"] }))] })) })] }));
 }

package/dist/commands/github/auth.d.ts

@@ -0,0 +1,2 @@
+export declare const description = "Authenticate with GitHub via the gh CLI";
+export default function GithubAuth(): import("react/jsx-runtime").JSX.Element;

package/dist/commands/github/auth.js

@@ -0,0 +1,56 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Text, Box } from "ink";
+import Spinner from "ink-spinner";
+import { exec } from "child_process";
+import { promisify } from "util";
+import { findMainRepoRoot } from "../../lib/git.js";
+import { getAuthenticatedUser } from "../../lib/trackers/github/auth.js";
+import { setRepoTracker } from "../../lib/trackers/index.js";
+const execAsync = promisify(exec);
+export const description = "Authenticate with GitHub via the gh CLI";
+export default function GithubAuth() {
+    const [status, setStatus] = useState("checking");
+    const [message, setMessage] = useState("");
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        async function run() {
+            await new Promise((r) => setTimeout(r, 100));
+            const repoRoot = findMainRepoRoot();
+            if (!repoRoot) {
+                setError("Not inside a git repository");
+                setStatus("error");
+                return;
+            }
+            let user = await getAuthenticatedUser();
+            if (!user) {
+                setStatus("logging-in");
+                try {
+                    await execAsync("gh auth login -p https -h github.com -w", { stdio: "inherit" });
+                }
+                catch (e) {
+                    setError(e instanceof Error ? e.message : "gh auth login failed");
+                    setStatus("error");
+                    return;
+                }
+                user = await getAuthenticatedUser();
+                if (!user) {
+                    setError("gh auth login completed but no authenticated user — try `gh auth status`");
+                    setStatus("error");
+                    return;
+                }
+            }
+            setRepoTracker(repoRoot, "github");
+            setMessage(`Authenticated as @${user.login}; this repo now uses GitHub Issues`);
+            setStatus("done");
+        }
+        run();
+    }, []);
+    useEffect(() => {
+        if (status === "done" || status === "error") {
+            const timer = setTimeout(() => process.exit(status === "error" ? 1 : 0), 100);
+            return () => clearTimeout(timer);
+        }
+    }, [status]);
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "GitHub Auth" }) }), status === "checking" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Checking gh auth status..." })] })), status === "logging-in" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Running `gh auth login` \u2014 follow the browser prompt..." })] })), status === "done" && (_jsxs(Text, { color: "green", bold: true, children: ["\u2713 ", message] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", error] }))] }));
+}

package/dist/commands/github/index.d.ts

@@ -0,0 +1 @@
+export declare const description = "GitHub Issues tracker commands";

package/dist/commands/github/index.js

@@ -0,0 +1 @@
+export const description = "GitHub Issues tracker commands";

package/dist/commands/helpers/template.d.ts

@@ -2,6 +2,7 @@ import { z } from "zod/v4";
 export declare const description = "Render a template to stdout";
 export declare const args: z.ZodTuple<[z.ZodEnum<{
     linear: "linear";
+    ticket: "ticket";
     review: "review";
     pr: "pr";
     "git-changes": "git-changes";

package/dist/commands/helpers/template.js

@@ -6,13 +6,13 @@ import { argument } from "pastel";
 import { z } from "zod/v4";
 import { findRepoRoot, findMainRepoRoot, getCurrentBranch, extractTicketId, } from "../../lib/git.js";
 import { renderTicket } from "../../lib/prompts.js";
-import { getTicketContent } from "../../lib/linear.js";
+import { getIssueTracker } from "../../lib/trackers/index.js";
 import { resolveAIContext, renderAIPrompt, fetchAndRenderPR, fetchAndRenderDiff, } from "../../lib/ai.js";
 export const description = "Render a template to stdout";
 export const args = z.tuple([
-    z.enum(["linear", "git-changes", "pr", "fix-pr", "review"]).describe(argument({
+    z.enum(["ticket", "linear", "git-changes", "pr", "fix-pr", "review"]).describe(argument({
         name: "type",
-        description: "Template type (linear, git-changes, pr, fix-pr, or review)",
+        description: "Template type (ticket, git-changes, pr, fix-pr, or review)",
     })),
 ]);
 export default function Template({ args }) {
@@ -93,22 +93,24 @@ export default function Template({ args }) {
                 setTimeout(() => exit(), 100);
             }
             else {
+                const mainRoot = findMainRepoRoot() ?? repoRoot;
+                const tracker = getIssueTracker(mainRoot);
                 const ticketId = extractTicketId(branch);
                 if (!ticketId) {
                     setStatus("error");
-                    setMessage("Could not extract ticket ID from branch name. Expected format: user/TEAM-123-description");
+                    setMessage(`Could not extract ${tracker.issueNoun} ID from branch name '${branch}'.`);
                     setTimeout(() => exit(), 100);
                     return;
                 }
-                const mainRoot = findMainRepoRoot() ?? repoRoot;
-                const ticket = await getTicketContent(ticketId, mainRoot);
-                if (!ticket) {
+                const result = await tracker.getIssue(ticketId, mainRoot);
+                if (!result.ok) {
+                    const status = await tracker.getAuthStatus(mainRoot);
                     setStatus("error");
-                    setMessage(`Could not fetch Linear ticket ${ticketId}. Run 'santree linear auth' to authenticate.`);
+                    setMessage(`Could not fetch ${tracker.issueNoun} ${ticketId}.${status.hint ? ` ${status.hint}` : ""}`);
                     setTimeout(() => exit(), 100);
                     return;
                 }
-                process.stdout.write(renderTicket(ticket));
+                process.stdout.write(renderTicket(result.value, tracker.displayName));
                 setStatus("done");
                 setTimeout(() => exit(), 100);
             }
@@ -118,7 +120,8 @@ export default function Template({ args }) {
     if (status === "done")
         return null;
     const spinnerTexts = {
-        linear: "Fetching Linear ticket...",
+        ticket: "Fetching issue...",
+        linear: "Fetching issue...",
         "git-changes": "Gathering changes...",
         pr: "Fetching PR feedback...",
         "fix-pr": "Building fix-pr prompt...",

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

@@ -0,0 +1 @@
+export declare const description = "Issue tracker commands (Linear / GitHub)";

package/dist/commands/issue/index.js

@@ -0,0 +1 @@
+export const description = "Issue tracker commands (Linear / GitHub)";

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

@@ -0,0 +1,2 @@
+export declare const description = "Open the current branch's issue in the browser";
+export default function IssueOpen(): import("react/jsx-runtime").JSX.Element;

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({