santree 0.0.12 → 0.0.14

package/README.md

@@ -83,6 +83,7 @@ santree clean
 | `santree work` | Launch Claude AI to work on the current ticket |
 | `santree clean` | Remove worktrees with merged/closed PRs |
 | `santree doctor` | Check system requirements and integrations |
+| `santree editor` | Open workspace file in VSCode or Cursor |
 | `santree statusline` | Statusline wrapper for Claude Code |
 
 ---
@@ -173,6 +174,11 @@ Removes the worktree and deletes the branch. Uses force mode by default (removes
 ### clean
 Shows worktrees with merged/closed PRs and prompts for confirmation before removing.
 
+### editor
+| Option | Description |
+|--------|-------------|
+| `--editor <cmd>` | Editor command to use (default: `code`). Also configurable via `SANTREE_EDITOR` env var |
+
 ### work
 | Option | Description |
 |--------|-------------|
@@ -190,3 +196,4 @@ Shows worktrees with merged/closed PRs and prompts for confirmation before remov
 | Git | Worktree operations |
 | GitHub CLI (`gh`) | PR integration |
 | tmux | Optional: new window support |
+| VSCode (`code`) or Cursor (`cursor`) | Optional: workspace editor |

package/dist/commands/doctor.js

@@ -228,6 +228,26 @@ export default function Doctor() {
                 checkTool("claude", "Claude Code CLI", true, "claude --version 2>/dev/null | head -1", "Install: npm install -g @anthropic-ai/claude-code"),
                 checkTool("happy", "Claude CLI wrapper", true, "happy --version 2>/dev/null || echo 'installed'", "Install: npm install -g happy-coder"),
             ]);
+            // Check for either code or cursor (only need one)
+            const [codeCheck, cursorCheck] = await Promise.all([
+                checkTool("code", "VSCode editor", false, "code --version | head -1", ""),
+                checkTool("cursor", "Cursor editor", false, "cursor --version | head -1", ""),
+            ]);
+            if (codeCheck.installed) {
+                results.push({ ...codeCheck, description: "Editor (VSCode)" });
+            }
+            else if (cursorCheck.installed) {
+                results.push({ ...cursorCheck, description: "Editor (Cursor)" });
+            }
+            else {
+                results.push({
+                    name: "code/cursor",
+                    description: "Editor (VSCode or Cursor)",
+                    required: false,
+                    installed: false,
+                    hint: "Install VSCode (https://code.visualstudio.com) or Cursor (https://cursor.sh)",
+                });
+            }
             const mcpResult = await checkLinearMcp();
             const statuslineResult = await checkStatusline();
             setTools(results);

package/dist/commands/editor.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const description = "Open workspace file in VSCode or Cursor";
+export declare const options: z.ZodObject<{
+    editor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Props = {
+    options: z.infer<typeof options>;
+};
+export default function Editor({ options: opts }: Props): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/commands/editor.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Text, Box } from "ink";
+import { z } from "zod";
+import { findMainRepoRoot } from "../lib/git.js";
+import { execSync, spawn } from "child_process";
+import * as fs from "fs";
+import * as path from "path";
+export const description = "Open workspace file in VSCode or Cursor";
+export const options = z.object({
+    editor: z
+        .string()
+        .optional()
+        .describe("Editor command (code, cursor)"),
+});
+export default function Editor({ options: opts }) {
+    const [status, setStatus] = useState({ state: "loading" });
+    useEffect(() => {
+        const repoRoot = findMainRepoRoot();
+        if (!repoRoot) {
+            setStatus({ state: "error", message: "Not inside a git repository" });
+            return;
+        }
+        // Find *.code-workspace file
+        let workspaceFile = null;
+        try {
+            const entries = fs.readdirSync(repoRoot);
+            const wsFiles = entries
+                .filter((f) => f.endsWith(".code-workspace"))
+                .sort();
+            if (wsFiles.length > 0) {
+                workspaceFile = wsFiles[0];
+            }
+        }
+        catch {
+            setStatus({ state: "error", message: "Failed to read repository root" });
+            return;
+        }
+        if (!workspaceFile) {
+            setStatus({
+                state: "error",
+                message: `No .code-workspace file found in ${repoRoot}`,
+            });
+            return;
+        }
+        // Resolve editor: --editor flag > SANTREE_EDITOR env > "code" default
+        const editor = opts.editor || process.env.SANTREE_EDITOR || "code";
+        // Validate editor exists in PATH
+        try {
+            execSync(`which ${editor}`, { stdio: "ignore" });
+        }
+        catch {
+            setStatus({
+                state: "error",
+                message: `Editor "${editor}" not found in PATH`,
+            });
+            return;
+        }
+        // Spawn editor detached
+        const fullPath = path.join(repoRoot, workspaceFile);
+        const child = spawn(editor, [fullPath], {
+            detached: true,
+            stdio: "ignore",
+        });
+        child.unref();
+        setStatus({ state: "done", repo: repoRoot, file: workspaceFile, editor });
+    }, []);
+    if (status.state === "loading") {
+        return null;
+    }
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "Editor" }) }), _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: status.state === "error" ? "red" : "green", paddingX: 1, width: "100%", children: [status.state === "done" && (_jsxs(_Fragment, { children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "repo:" }), _jsx(Text, { dimColor: true, children: status.repo })] }), _jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "file:" }), _jsx(Text, { color: "cyan", bold: true, children: status.file })] }), _jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "editor:" }), _jsx(Text, { dimColor: true, children: status.editor })] })] })), status.state === "error" && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "error:" }), _jsx(Text, { color: "red", children: status.message })] }))] }), _jsxs(Box, { marginTop: 1, children: [status.state === "done" && (_jsxs(Text, { color: "green", bold: true, children: ["\u2713 Opened workspace in ", status.editor] })), status.state === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", status.message] }))] })] }));
+}

package/dist/commands/statusline.js

@@ -132,7 +132,7 @@ function formatChanges(changes) {
 // Build statusline for santree worktree
 function buildSantreeStatusline(cwd, metadata, model, usedPercentage) {
     const parts = [];
-    const branch = metadata.branch_name || git(cwd, "rev-parse --abbrev-ref HEAD") || "unknown";
+    const branch = git(cwd, "rev-parse --abbrev-ref HEAD") || "unknown";
     // Ticket ID (prominent)
     const ticketId = extractTicketId(branch);
     if (ticketId) {

package/dist/lib/git.d.ts

@@ -25,9 +25,7 @@ export declare function removeWorktree(branchName: string, repoRoot: string, for
 export declare function extractTicketId(branch: string): string | null;
 export declare function getWorktreePath(branchName: string): string | null;
 export declare function getWorktreeMetadata(worktreePath: string): {
-    branch_name?: string;
     base_branch?: string;
-    created_at?: string;
 } | null;
 export declare function hasUncommittedChanges(): boolean;
 export declare function hasStagedChanges(): boolean;

package/dist/lib/git.js

@@ -130,7 +130,11 @@ export function getWorktreesDir(repoRoot) {
     return path.join(getSantreeDir(repoRoot), "worktrees");
 }
 export async function createWorktree(branchName, baseBranch, repoRoot) {
-    const dirName = branchName.replace(/\//g, "__");
+    const ticketId = extractTicketId(branchName);
+    if (!ticketId) {
+        return { success: false, error: "No ticket ID found in branch name (expected pattern like TEAM-123)" };
+    }
+    const dirName = ticketId;
     const worktreesDir = getWorktreesDir(repoRoot);
     const worktreePath = path.join(worktreesDir, dirName);
     if (fs.existsSync(worktreePath)) {
@@ -164,9 +168,7 @@ export async function createWorktree(branchName, baseBranch, repoRoot) {
         }
         // Save metadata
         const metadata = {
-            branch_name: branchName,
             base_branch: baseBranch,
-            created_at: new Date().toISOString(),
         };
         fs.writeFileSync(path.join(worktreePath, ".santree_metadata.json"), JSON.stringify(metadata, null, 2));
         return { success: true, path: worktreePath };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "santree",
-	"version": "0.0.12",
+	"version": "0.0.14",
 	"description": "Git worktree manager with Linear integration",
 	"license": "MIT",
 	"author": "Santiago Toscanini",