@knowsuchagency/fulcrum 1.3.0 → 1.5.0

package/bin/fulcrum.js

@@ -43866,12 +43866,16 @@ function registerTools(server, client) {
       return handleToolError(err);
     }
   });
-  server.tool("get_task", "Get details of a specific task by ID", {
+  server.tool("get_task", "Get details of a specific task by ID, including dependencies and attachments", {
     id: exports_external.string().describe("Task ID (UUID)")
   }, async ({ id }) => {
     try {
-      const task = await client.getTask(id);
-      return formatSuccess(task);
+      const [task, dependencies, attachments] = await Promise.all([
+        client.getTask(id),
+        client.getTaskDependencies(id),
+        client.listTaskAttachments(id)
+      ]);
+      return formatSuccess({ ...task, dependencies, attachments });
     } catch (err) {
       return handleToolError(err);
     }
@@ -46168,15 +46172,62 @@ var STATUS_MAP = {
   cancel: "CANCELED",
   "in-progress": "IN_PROGRESS"
 };
-function formatTask(task) {
+function formatTask(task, dependencies, attachments) {
   console.log(`${task.title}`);
-  console.log(`  ID:       ${task.id}`);
-  console.log(`  Status:   ${task.status}`);
-  console.log(`  Repo:     ${task.repoName}`);
+  console.log(`  ID:         ${task.id}`);
+  console.log(`  Status:     ${task.status}`);
+  if (task.description) {
+    console.log(`  Description: ${task.description}`);
+  }
+  if (task.repoName)
+    console.log(`  Repo:       ${task.repoName}`);
   if (task.branch)
-    console.log(`  Branch:   ${task.branch}`);
+    console.log(`  Branch:     ${task.branch}`);
+  if (task.worktreePath)
+    console.log(`  Worktree:   ${task.worktreePath}`);
   if (task.prUrl)
-    console.log(`  PR:       ${task.prUrl}`);
+    console.log(`  PR:         ${task.prUrl}`);
+  if (task.links && task.links.length > 0) {
+    console.log(`  Links:      ${task.links.map((l2) => l2.label || l2.url).join(", ")}`);
+  }
+  if (task.labels && task.labels.length > 0) {
+    console.log(`  Labels:     ${task.labels.join(", ")}`);
+  }
+  if (task.dueDate)
+    console.log(`  Due:        ${task.dueDate}`);
+  if (task.projectId)
+    console.log(`  Project:    ${task.projectId}`);
+  console.log(`  Agent:      ${task.agent}`);
+  if (task.aiMode)
+    console.log(`  AI Mode:    ${task.aiMode}`);
+  if (task.agentOptions && Object.keys(task.agentOptions).length > 0) {
+    console.log(`  Options:    ${JSON.stringify(task.agentOptions)}`);
+  }
+  if (dependencies) {
+    if (dependencies.isBlocked) {
+      console.log(`  Blocked:    Yes`);
+    }
+    if (dependencies.dependsOn.length > 0) {
+      console.log(`  Depends on: ${dependencies.dependsOn.length} task(s)`);
+      for (const dep of dependencies.dependsOn) {
+        if (dep.task) {
+          console.log(`    - ${dep.task.title} [${dep.task.status}]`);
+        }
+      }
+    }
+    if (dependencies.dependents.length > 0) {
+      console.log(`  Blocking:   ${dependencies.dependents.length} task(s)`);
+    }
+  }
+  if (attachments && attachments.length > 0) {
+    console.log(`  Attachments: ${attachments.length} file(s)`);
+  }
+  if (task.notes) {
+    console.log(`  Notes:      ${task.notes}`);
+  }
+  console.log(`  Created:    ${task.createdAt}`);
+  if (task.startedAt)
+    console.log(`  Started:    ${task.startedAt}`);
 }
 async function findCurrentTask(client, pathOverride) {
   if (process.env.FULCRUM_TASK_ID) {
@@ -46204,9 +46255,17 @@ async function handleCurrentTaskCommand(action, rest, flags) {
   if (!action) {
     const task2 = await findCurrentTask(client, pathOverride);
     if (isJsonOutput()) {
-      output(task2);
+      const [dependencies, attachments] = await Promise.all([
+        client.getTaskDependencies(task2.id),
+        client.listTaskAttachments(task2.id)
+      ]);
+      output({ ...task2, dependencies, attachments });
     } else {
-      formatTask(task2);
+      const [dependencies, attachments] = await Promise.all([
+        client.getTaskDependencies(task2.id),
+        client.listTaskAttachments(task2.id)
+      ]);
+      formatTask(task2, dependencies, attachments);
     }
     return;
   }
@@ -46297,22 +46356,62 @@ init_client();
 import { basename as basename3 } from "path";
 init_errors();
 var VALID_STATUSES = ["TO_DO", "IN_PROGRESS", "IN_REVIEW", "CANCELED"];
-function formatTask2(task) {
+function formatTask2(task, dependencies, attachments) {
   console.log(`${task.title}`);
-  console.log(`  ID:       ${task.id}`);
-  console.log(`  Status:   ${task.status}`);
+  console.log(`  ID:         ${task.id}`);
+  console.log(`  Status:     ${task.status}`);
+  if (task.description) {
+    console.log(`  Description: ${task.description}`);
+  }
   if (task.repoName)
-    console.log(`  Repo:     ${task.repoName}`);
+    console.log(`  Repo:       ${task.repoName}`);
   if (task.branch)
-    console.log(`  Branch:   ${task.branch}`);
+    console.log(`  Branch:     ${task.branch}`);
+  if (task.worktreePath)
+    console.log(`  Worktree:   ${task.worktreePath}`);
   if (task.prUrl)
-    console.log(`  PR:       ${task.prUrl}`);
-  if (task.projectId)
-    console.log(`  Project:  ${task.projectId}`);
-  if (task.labels && task.labels.length > 0)
-    console.log(`  Labels:   ${task.labels.join(", ")}`);
+    console.log(`  PR:         ${task.prUrl}`);
+  if (task.links && task.links.length > 0) {
+    console.log(`  Links:      ${task.links.map((l2) => l2.label || l2.url).join(", ")}`);
+  }
+  if (task.labels && task.labels.length > 0) {
+    console.log(`  Labels:     ${task.labels.join(", ")}`);
+  }
   if (task.dueDate)
-    console.log(`  Due:      ${task.dueDate}`);
+    console.log(`  Due:        ${task.dueDate}`);
+  if (task.projectId)
+    console.log(`  Project:    ${task.projectId}`);
+  console.log(`  Agent:      ${task.agent}`);
+  if (task.aiMode)
+    console.log(`  AI Mode:    ${task.aiMode}`);
+  if (task.agentOptions && Object.keys(task.agentOptions).length > 0) {
+    console.log(`  Options:    ${JSON.stringify(task.agentOptions)}`);
+  }
+  if (dependencies) {
+    if (dependencies.isBlocked) {
+      console.log(`  Blocked:    Yes`);
+    }
+    if (dependencies.dependsOn.length > 0) {
+      console.log(`  Depends on: ${dependencies.dependsOn.length} task(s)`);
+      for (const dep of dependencies.dependsOn) {
+        if (dep.task) {
+          console.log(`    - ${dep.task.title} [${dep.task.status}]`);
+        }
+      }
+    }
+    if (dependencies.dependents.length > 0) {
+      console.log(`  Blocking:   ${dependencies.dependents.length} task(s)`);
+    }
+  }
+  if (attachments && attachments.length > 0) {
+    console.log(`  Attachments: ${attachments.length} file(s)`);
+  }
+  if (task.notes) {
+    console.log(`  Notes:      ${task.notes}`);
+  }
+  console.log(`  Created:    ${task.createdAt}`);
+  if (task.startedAt)
+    console.log(`  Started:    ${task.startedAt}`);
 }
 function formatTaskList(tasks) {
   if (tasks.length === 0) {
@@ -46394,10 +46493,14 @@ async function handleTasksCommand(action, positional, flags) {
         throw new CliError("MISSING_ID", "Task ID required", ExitCodes.INVALID_ARGS);
       }
       const task = await client.getTask(id);
+      const [dependencies, attachments] = await Promise.all([
+        client.getTaskDependencies(id),
+        client.listTaskAttachments(id)
+      ]);
       if (isJsonOutput()) {
-        output(task);
+        output({ ...task, dependencies, attachments });
       } else {
-        formatTask2(task);
+        formatTask2(task, dependencies, attachments);
       }
       break;
     }
@@ -46649,8 +46752,98 @@ Labels:`);
       }
       break;
     }
+    case "attachments": {
+      const [subAction, taskIdOrFile, fileOrAttachmentId] = positional;
+      if (!subAction || subAction === "help") {
+        console.log("Usage:");
+        console.log("  fulcrum tasks attachments list <task-id>");
+        console.log("  fulcrum tasks attachments upload <task-id> <file-path>");
+        console.log("  fulcrum tasks attachments delete <task-id> <attachment-id>");
+        console.log("  fulcrum tasks attachments path <task-id> <attachment-id>");
+        break;
+      }
+      if (subAction === "list") {
+        const taskId = taskIdOrFile;
+        if (!taskId) {
+          throw new CliError("MISSING_ID", "Task ID required", ExitCodes.INVALID_ARGS);
+        }
+        const attachments = await client.listTaskAttachments(taskId);
+        if (isJsonOutput()) {
+          output(attachments);
+        } else {
+          if (attachments.length === 0) {
+            console.log("No attachments");
+          } else {
+            console.log(`
+Attachments (${attachments.length}):`);
+            for (const att of attachments) {
+              console.log(`  ${att.filename}`);
+              console.log(`    ID:   ${att.id}`);
+              console.log(`    Type: ${att.mimeType}`);
+              console.log(`    Size: ${att.size} bytes`);
+            }
+          }
+        }
+        break;
+      }
+      if (subAction === "upload") {
+        const taskId = taskIdOrFile;
+        const filePath = fileOrAttachmentId;
+        if (!taskId) {
+          throw new CliError("MISSING_ID", "Task ID required", ExitCodes.INVALID_ARGS);
+        }
+        if (!filePath) {
+          throw new CliError("MISSING_FILE", "File path required", ExitCodes.INVALID_ARGS);
+        }
+        const attachment = await client.uploadTaskAttachment(taskId, filePath);
+        if (isJsonOutput()) {
+          output(attachment);
+        } else {
+          console.log(`Uploaded: ${attachment.filename}`);
+          console.log(`  ID: ${attachment.id}`);
+        }
+        break;
+      }
+      if (subAction === "delete") {
+        const taskId = taskIdOrFile;
+        const attachmentId = fileOrAttachmentId;
+        if (!taskId) {
+          throw new CliError("MISSING_ID", "Task ID required", ExitCodes.INVALID_ARGS);
+        }
+        if (!attachmentId) {
+          throw new CliError("MISSING_ATTACHMENT_ID", "Attachment ID required", ExitCodes.INVALID_ARGS);
+        }
+        await client.deleteTaskAttachment(taskId, attachmentId);
+        if (isJsonOutput()) {
+          output({ success: true, deleted: attachmentId });
+        } else {
+          console.log(`Deleted attachment: ${attachmentId}`);
+        }
+        break;
+      }
+      if (subAction === "path") {
+        const taskId = taskIdOrFile;
+        const attachmentId = fileOrAttachmentId;
+        if (!taskId) {
+          throw new CliError("MISSING_ID", "Task ID required", ExitCodes.INVALID_ARGS);
+        }
+        if (!attachmentId) {
+          throw new CliError("MISSING_ATTACHMENT_ID", "Attachment ID required", ExitCodes.INVALID_ARGS);
+        }
+        const result = await client.getTaskAttachmentPath(taskId, attachmentId);
+        if (isJsonOutput()) {
+          output(result);
+        } else {
+          console.log(`Path: ${result.path}`);
+          console.log(`Filename: ${result.filename}`);
+          console.log(`Type: ${result.mimeType}`);
+        }
+        break;
+      }
+      throw new CliError("UNKNOWN_SUBACTION", `Unknown attachments action: ${subAction}. Valid: list, upload, delete, path`, ExitCodes.INVALID_ARGS);
+    }
     default:
-      throw new CliError("UNKNOWN_ACTION", `Unknown action: ${action}. Valid: list, get, create, update, move, delete, add-label, remove-label, set-due-date, add-dependency, remove-dependency, list-dependencies, labels`, ExitCodes.INVALID_ARGS);
+      throw new CliError("UNKNOWN_ACTION", `Unknown action: ${action}. Valid: list, get, create, update, move, delete, add-label, remove-label, set-due-date, add-dependency, remove-dependency, list-dependencies, labels, attachments`, ExitCodes.INVALID_ARGS);
   }
 }
 
@@ -47617,8 +47810,8 @@ async function handleFsCommand(action, positional, flags) {
 
 // cli/src/commands/up.ts
 import { spawn } from "child_process";
-import { existsSync as existsSync3 } from "fs";
-import { dirname as dirname2, join as join3 } from "path";
+import { existsSync as existsSync4 } from "fs";
+import { dirname as dirname3, join as join4 } from "path";
 import { fileURLToPath } from "url";
 init_errors();
 
@@ -47899,1093 +48092,77 @@ function installUv() {
     return false;
   return installDependency(dep);
 }
-// package.json
-var package_default = {
-  name: "@knowsuchagency/fulcrum",
-  private: true,
-  version: "1.3.0",
-  description: "Harness Attention. Orchestrate Agents. Ship.",
-  license: "PolyForm-Perimeter-1.0.0",
-  type: "module",
-  scripts: {
-    dev: "vite --host",
-    "dev:server": "mkdir -p ~/.fulcrum && bun --watch server/index.ts",
-    build: "tsc -b && vite build",
-    start: "NODE_ENV=production bun server/index.ts",
-    lint: "eslint .",
-    preview: "vite preview",
-    "db:generate": "drizzle-kit generate",
-    "db:migrate": "drizzle-kit migrate",
-    "db:studio": "drizzle-kit studio"
-  },
-  dependencies: {
-    "@atlaskit/pragmatic-drag-and-drop": "^1.7.7",
-    "@atlaskit/pragmatic-drag-and-drop-hitbox": "^1.1.0",
-    "@azurity/pure-nerd-font": "^3.0.5",
-    "@base-ui/react": "^1.0.0",
-    "@dagrejs/dagre": "^1.1.8",
-    "@fontsource-variable/jetbrains-mono": "^5.2.8",
-    "@hono/node-server": "^1.19.7",
-    "@hono/node-ws": "^1.2.0",
-    "@hugeicons/core-free-icons": "^3.0.0",
-    "@hugeicons/react": "^1.1.3",
-    "@monaco-editor/react": "^4.7.0",
-    "@octokit/rest": "^22.0.1",
-    "@radix-ui/react-collapsible": "^1.1.12",
-    "@tailwindcss/vite": "^4.1.17",
-    "@tanstack/react-query": "^5.90.12",
-    "@tanstack/react-router": "^1.141.8",
-    "@uiw/react-markdown-preview": "^5.1.5",
-    "@xterm/addon-clipboard": "^0.2.0",
-    "@xterm/addon-fit": "^0.10.0",
-    "@xterm/addon-web-links": "^0.11.0",
-    "@xterm/xterm": "^5.5.0",
-    "bun-pty": "^0.4.2",
-    citty: "^0.1.6",
-    "class-variance-authority": "^0.7.1",
-    cloudflare: "^5.2.0",
-    clsx: "^2.1.1",
-    "date-fns": "^4.1.0",
-    "drizzle-orm": "^0.45.1",
-    "fancy-ansi": "^0.1.3",
-    glob: "^13.0.0",
-    hono: "^4.11.1",
-    i18next: "^25.7.3",
-    mobx: "^6.15.0",
-    "mobx-react-lite": "^4.1.1",
-    "mobx-state-tree": "^7.0.2",
-    "next-themes": "^0.4.6",
-    react: "^19.2.0",
-    "react-day-picker": "^9.13.0",
-    "react-dom": "^19.2.0",
-    "react-i18next": "^16.5.0",
-    "react-resizable-panels": "^4.0.11",
-    reactflow: "^11.11.4",
-    recharts: "2.15.4",
-    shadcn: "^3.6.2",
-    shiki: "^3.20.0",
-    sonner: "^2.0.7",
-    "tailwind-merge": "^3.4.0",
-    tailwindcss: "^4.1.17",
-    "tw-animate-css": "^1.4.0",
-    ws: "^8.18.3",
-    yaml: "^2.8.2"
-  },
-  devDependencies: {
-    "@eslint/js": "^9.39.1",
-    "@opencode-ai/plugin": "^1.1.8",
-    "@tailwindcss/typography": "^0.5.19",
-    "@tanstack/router-plugin": "^1.141.8",
-    "@types/bun": "^1.2.14",
-    "@types/node": "^24.10.1",
-    "@types/react": "^19.2.5",
-    "@types/react-dom": "^19.2.3",
-    "@types/ws": "^8.18.1",
-    "@vitejs/plugin-react": "^5.1.1",
-    "drizzle-kit": "^0.31.8",
-    eslint: "^9.39.1",
-    "eslint-plugin-react-hooks": "^7.0.1",
-    "eslint-plugin-react-refresh": "^0.4.24",
-    globals: "^16.5.0",
-    typescript: "~5.9.3",
-    "typescript-eslint": "^8.46.4",
-    vite: "^7.2.4"
-  }
-};
 
-// cli/src/commands/up.ts
-function getPackageRoot() {
-  const currentFile = fileURLToPath(import.meta.url);
-  let dir = dirname2(currentFile);
-  for (let i2 = 0;i2 < 5; i2++) {
-    if (existsSync3(join3(dir, "server", "index.js"))) {
-      return dir;
+// cli/src/commands/claude.ts
+init_errors();
+import { spawnSync as spawnSync2 } from "child_process";
+import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync3, existsSync as existsSync3, rmSync, readFileSync as readFileSync4 } from "fs";
+import { homedir as homedir2 } from "os";
+import { dirname as dirname2, join as join3 } from "path";
+
+// plugins/fulcrum/.claude-plugin/marketplace.json
+var marketplace_default = `{
+  "name": "fulcrum",
+  "owner": {
+    "name": "Fulcrum"
+  },
+  "plugins": [
+    {
+      "name": "fulcrum",
+      "source": "./",
+      "description": "Task orchestration for Claude Code",
+      "version": "1.5.0",
+      "skills": [
+        "./skills/fulcrum"
+      ],
+      "keywords": [
+        "fulcrum",
+        "task",
+        "orchestration",
+        "worktree"
+      ]
     }
-    dir = dirname2(dir);
+  ],
+  "metadata": {
+    "description": "Fulcrum task orchestration plugin marketplace",
+    "version": "1.0.0"
   }
-  return dirname2(dirname2(dirname2(currentFile)));
 }
-async function handleUpCommand(flags) {
-  const autoYes = flags.yes === "true" || flags.y === "true";
-  if (needsViboraMigration()) {
-    const viboraDir = getLegacyViboraDir();
-    console.error(`
-Found existing Vibora data at ${viboraDir}`);
-    console.error('Run "fulcrum migrate-from-vibora" to copy your data to ~/.fulcrum');
-    console.error("");
-  }
-  if (!isBunInstalled()) {
-    const bunDep = getDependency("bun");
-    const method = getInstallMethod(bunDep);
-    console.error("Bun is required to run Fulcrum but is not installed.");
-    console.error("  Bun is the JavaScript runtime that powers Fulcrum.");
-    const shouldInstall = autoYes || await confirm(`Would you like to install bun via ${method}?`);
-    if (shouldInstall) {
-      const success2 = installBun();
-      if (!success2) {
-        throw new CliError("INSTALL_FAILED", "Failed to install bun", ExitCodes.ERROR);
+`;
+
+// plugins/fulcrum/hooks/hooks.json
+var hooks_default = `{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "fulcrum current-task review 2>/dev/null || true"
+          }
+        ]
       }
-      console.error("Bun installed successfully!");
-    } else {
-      throw new CliError("MISSING_DEPENDENCY", `Bun is required. Install manually: ${getInstallCommand(bunDep)}`, ExitCodes.ERROR);
-    }
-  }
-  if (!isDtachInstalled()) {
-    const dtachDep = getDependency("dtach");
-    const method = getInstallMethod(dtachDep);
-    console.error("dtach is required for terminal persistence but is not installed.");
-    console.error("  dtach enables persistent terminal sessions that survive disconnects.");
-    const shouldInstall = autoYes || await confirm(`Would you like to install dtach via ${method}?`);
-    if (shouldInstall) {
-      const success2 = installDtach();
-      if (!success2) {
-        throw new CliError("INSTALL_FAILED", "Failed to install dtach", ExitCodes.ERROR);
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "fulcrum current-task in-progress 2>/dev/null || true"
+          }
+        ]
       }
-      console.error("dtach installed successfully!");
-    } else {
-      throw new CliError("MISSING_DEPENDENCY", `dtach is required. Install manually: ${getInstallCommand(dtachDep)}`, ExitCodes.ERROR);
-    }
-  }
-  if (!isUvInstalled()) {
-    const uvDep = getDependency("uv");
-    const method = getInstallMethod(uvDep);
-    console.error("uv is required but is not installed.");
-    console.error("  uv is a fast Python package manager used by Claude Code.");
-    const shouldInstall = autoYes || await confirm(`Would you like to install uv via ${method}?`);
-    if (shouldInstall) {
-      const success2 = installUv();
-      if (!success2) {
-        throw new CliError("INSTALL_FAILED", "Failed to install uv", ExitCodes.ERROR);
-      }
-      console.error("uv installed successfully!");
-    } else {
-      throw new CliError("MISSING_DEPENDENCY", `uv is required. Install manually: ${getInstallCommand(uvDep)}`, ExitCodes.ERROR);
-    }
-  }
-  const existingPid = readPid();
-  if (existingPid && isProcessRunning(existingPid)) {
-    console.error(`Fulcrum server is already running (PID: ${existingPid})`);
-    const shouldReplace = autoYes || await confirm("Would you like to stop it and start a new instance?");
-    if (shouldReplace) {
-      console.error("Stopping existing instance...");
-      process.kill(existingPid, "SIGTERM");
-      let attempts = 0;
-      while (attempts < 50 && isProcessRunning(existingPid)) {
-        await new Promise((resolve) => setTimeout(resolve, 100));
-        attempts++;
-      }
-      if (isProcessRunning(existingPid)) {
-        process.kill(existingPid, "SIGKILL");
-      }
-      removePid();
-      console.error("Existing instance stopped.");
-    } else {
-      throw new CliError("ALREADY_RUNNING", `Server already running at http://localhost:${getPort(flags.port)}`, ExitCodes.ERROR);
-    }
-  }
-  const port = getPort(flags.port);
-  if (flags.port) {
-    updateSettingsPort(port);
-  }
-  const host = flags.host ? "0.0.0.0" : "localhost";
-  const packageRoot = getPackageRoot();
-  const serverPath = join3(packageRoot, "server", "index.js");
-  const platform2 = process.platform;
-  const arch = process.arch;
-  let ptyLibName;
-  if (platform2 === "darwin") {
-    ptyLibName = arch === "arm64" ? "librust_pty_arm64.dylib" : "librust_pty.dylib";
-  } else if (platform2 === "win32") {
-    ptyLibName = "rust_pty.dll";
-  } else {
-    ptyLibName = arch === "arm64" ? "librust_pty_arm64.so" : "librust_pty.so";
-  }
-  const ptyLibPath = join3(packageRoot, "lib", ptyLibName);
-  const fulcrumDir = getFulcrumDir();
-  const debug = flags.debug === "true";
-  console.error(`Starting Fulcrum server${debug ? " (debug mode)" : ""}...`);
-  const serverProc = spawn("bun", [serverPath], {
-    detached: true,
-    stdio: "ignore",
-    env: {
-      ...process.env,
-      NODE_ENV: "production",
-      PORT: port.toString(),
-      HOST: host,
-      FULCRUM_DIR: fulcrumDir,
-      FULCRUM_PACKAGE_ROOT: packageRoot,
-      FULCRUM_VERSION: package_default.version,
-      BUN_PTY_LIB: ptyLibPath,
-      ...isClaudeInstalled() && { FULCRUM_CLAUDE_INSTALLED: "1" },
-      ...isOpencodeInstalled() && { FULCRUM_OPENCODE_INSTALLED: "1" },
-      ...debug && { LOG_LEVEL: "debug", DEBUG: "1" }
-    }
-  });
-  serverProc.unref();
-  const pid = serverProc.pid;
-  if (!pid) {
-    throw new CliError("START_FAILED", "Failed to start server process", ExitCodes.ERROR);
-  }
-  writePid(pid);
-  await new Promise((resolve) => setTimeout(resolve, 1000));
-  if (!isProcessRunning(pid)) {
-    throw new CliError("START_FAILED", "Server process died immediately after starting", ExitCodes.ERROR);
-  }
-  if (isJsonOutput()) {
-    output({
-      pid,
-      port,
-      url: `http://localhost:${port}`
-    });
-  } else {
-    const hasAgent = isClaudeInstalled() || isOpencodeInstalled();
-    showGettingStartedTips(port, hasAgent);
-  }
-}
-function showGettingStartedTips(port, hasAgent) {
-  console.error(`
-Fulcrum is running at http://localhost:${port}
-
-Getting Started:
-  1. Open http://localhost:${port} in your browser
-  2. Add a repository to get started
-  3. Create a task to spin up an isolated worktree
-  4. Run your AI agent in the task terminal
-
-Commands:
-  fulcrum status    Check server status
-  fulcrum doctor    Check all dependencies
-  fulcrum down      Stop the server
-`);
-  if (!hasAgent) {
-    console.error(`Note: No AI agents detected. Install one to get started:
-  Claude Code: curl -fsSL https://claude.ai/install.sh | bash
-  OpenCode:    curl -fsSL https://opencode.ai/install | bash
-`);
-  }
-}
-
-// cli/src/commands/down.ts
-init_errors();
-async function handleDownCommand() {
-  const pid = readPid();
-  if (!pid) {
-    throw new CliError("NOT_RUNNING", "No PID file found. Fulcrum server may not be running.", ExitCodes.ERROR);
-  }
-  if (!isProcessRunning(pid)) {
-    removePid();
-    if (isJsonOutput()) {
-      output({ stopped: true, pid, wasRunning: false });
-    } else {
-      console.log(`Fulcrum was not running (stale PID file cleaned up)`);
-    }
-    return;
-  }
-  try {
-    process.kill(pid, "SIGTERM");
-  } catch (err) {
-    throw new CliError("KILL_FAILED", `Failed to stop server (PID: ${pid}): ${err}`, ExitCodes.ERROR);
-  }
-  let attempts = 0;
-  while (attempts < 50 && isProcessRunning(pid)) {
-    await new Promise((resolve) => setTimeout(resolve, 100));
-    attempts++;
-  }
-  if (isProcessRunning(pid)) {
-    try {
-      process.kill(pid, "SIGKILL");
-    } catch {}
-  }
-  removePid();
-  if (isJsonOutput()) {
-    output({ stopped: true, pid, wasRunning: true });
-  } else {
-    console.log(`Fulcrum stopped (PID: ${pid})`);
-  }
-}
-
-// cli/src/commands/migrate-from-vibora.ts
-init_server();
-async function handleMigrateFromViboraCommand(flags) {
-  const autoYes = flags.yes === "true" || flags.y === "true";
-  if (!needsViboraMigration()) {
-    if (isJsonOutput()) {
-      output({ migrated: false, reason: "no_migration_needed" });
-    } else {
-      console.error("No migration needed.");
-      console.error(`  ~/.vibora does not exist or ~/.fulcrum already has data.`);
-    }
-    return;
-  }
-  const viboraDir = getLegacyViboraDir();
-  const fulcrumDir = getFulcrumDir();
-  if (!isJsonOutput()) {
-    console.error(`
-Found existing Vibora data at ${viboraDir}`);
-    console.error("Fulcrum (formerly Vibora) now uses ~/.fulcrum for data storage.");
-    console.error("");
-    console.error("Your existing data can be copied to the new location.");
-    console.error("This is non-destructive - your ~/.vibora directory will be left untouched.");
-    console.error("");
-  }
-  const shouldMigrate = autoYes || await confirm("Would you like to copy your data to ~/.fulcrum?");
-  if (!shouldMigrate) {
-    if (isJsonOutput()) {
-      output({ migrated: false, reason: "user_declined" });
-    } else {
-      console.error("Migration skipped.");
-      console.error("You can run this command again later to migrate.");
-    }
-    return;
-  }
-  if (!isJsonOutput()) {
-    console.error("Copying data from ~/.vibora to ~/.fulcrum...");
-  }
-  const success2 = migrateFromVibora();
-  if (success2) {
-    if (isJsonOutput()) {
-      output({ migrated: true, from: viboraDir, to: fulcrumDir });
-    } else {
-      console.error("Migration complete!");
-      console.error(`  Data copied from ${viboraDir} to ${fulcrumDir}`);
-      console.error("  Your original ~/.vibora directory has been preserved.");
-    }
-  } else {
-    if (isJsonOutput()) {
-      output({ migrated: false, reason: "migration_failed" });
-    } else {
-      console.error("Migration failed.");
-      console.error("You can manually copy files from ~/.vibora to ~/.fulcrum");
-    }
-    process.exitCode = 1;
-  }
-}
-
-// cli/src/commands/status.ts
-init_server();
-async function handleStatusCommand(flags) {
-  const pid = readPid();
-  const port = getPort(flags.port);
-  const serverUrl = discoverServerUrl(flags.url, flags.port);
-  const pidRunning = pid !== null && isProcessRunning(pid);
-  let healthOk = false;
-  let version3 = null;
-  let uptime = null;
-  if (pidRunning) {
-    try {
-      const res = await fetch(`${serverUrl}/health`, { signal: AbortSignal.timeout(2000) });
-      healthOk = res.ok;
-      if (res.ok) {
-        const health = await res.json();
-        version3 = health.version || null;
-        uptime = health.uptime || null;
-      }
-    } catch {}
-  }
-  const data = {
-    running: pidRunning,
-    healthy: healthOk,
-    pid: pid || null,
-    port,
-    url: serverUrl,
-    version: version3,
-    uptime
-  };
-  if (isJsonOutput()) {
-    output(data);
-  } else {
-    if (pidRunning) {
-      const healthStatus = healthOk ? "healthy" : "not responding";
-      console.log(`Fulcrum is running (${healthStatus})`);
-      console.log(`  PID:  ${pid}`);
-      console.log(`  URL:  ${serverUrl}`);
-      if (version3)
-        console.log(`  Version: ${version3}`);
-      if (uptime)
-        console.log(`  Uptime:  ${Math.floor(uptime / 1000)}s`);
-    } else {
-      console.log("Fulcrum is not running");
-      console.log(`
-Start with: fulcrum up`);
-    }
-  }
-}
-
-// cli/src/commands/git.ts
-init_client();
-init_errors();
-async function handleGitCommand(action, flags) {
-  const client = new FulcrumClient(flags.url, flags.port);
-  switch (action) {
-    case "status": {
-      const path = flags.path || process.cwd();
-      const status = await client.getStatus(path);
-      if (isJsonOutput()) {
-        output(status);
-      } else {
-        console.log(`Branch: ${status.branch}`);
-        if (status.ahead)
-          console.log(`  Ahead: ${status.ahead}`);
-        if (status.behind)
-          console.log(`  Behind: ${status.behind}`);
-        if (status.staged?.length)
-          console.log(`  Staged: ${status.staged.length} files`);
-        if (status.modified?.length)
-          console.log(`  Modified: ${status.modified.length} files`);
-        if (status.untracked?.length)
-          console.log(`  Untracked: ${status.untracked.length} files`);
-        if (!status.staged?.length && !status.modified?.length && !status.untracked?.length) {
-          console.log("  Working tree clean");
-        }
-      }
-      break;
-    }
-    case "diff": {
-      const path = flags.path || process.cwd();
-      const diff = await client.getDiff(path, {
-        staged: flags.staged === "true",
-        ignoreWhitespace: flags["ignore-whitespace"] === "true",
-        includeUntracked: flags["include-untracked"] === "true"
-      });
-      if (isJsonOutput()) {
-        output(diff);
-      } else {
-        console.log(diff.diff || "No changes");
-      }
-      break;
-    }
-    case "branches": {
-      const repo = flags.repo;
-      if (!repo) {
-        throw new CliError("MISSING_REPO", "--repo is required", ExitCodes.INVALID_ARGS);
-      }
-      const branches = await client.getBranches(repo);
-      if (isJsonOutput()) {
-        output(branches);
-      } else {
-        for (const branch of branches) {
-          const current = branch.current ? "* " : "  ";
-          console.log(`${current}${branch.name}`);
-        }
-      }
-      break;
-    }
-    default:
-      throw new CliError("UNKNOWN_ACTION", `Unknown action: ${action}. Valid: status, diff, branches`, ExitCodes.INVALID_ARGS);
-  }
-}
-
-// cli/src/commands/worktrees.ts
-init_client();
-init_errors();
-async function handleWorktreesCommand(action, flags) {
-  const client = new FulcrumClient(flags.url, flags.port);
-  switch (action) {
-    case "list": {
-      const worktrees = await client.listWorktrees();
-      if (isJsonOutput()) {
-        output(worktrees);
-      } else {
-        if (worktrees.length === 0) {
-          console.log("No worktrees found");
-        } else {
-          for (const wt of worktrees) {
-            console.log(`${wt.path}`);
-            console.log(`  Branch: ${wt.branch}`);
-            if (wt.taskId)
-              console.log(`  Task: ${wt.taskId}`);
-          }
-        }
-      }
-      break;
-    }
-    case "delete": {
-      const worktreePath = flags.path;
-      if (!worktreePath) {
-        throw new CliError("MISSING_PATH", "--path is required", ExitCodes.INVALID_ARGS);
-      }
-      const deleteLinkedTask = flags["delete-task"] === "true" || flags["delete-task"] === "";
-      const result = await client.deleteWorktree(worktreePath, flags.repo, deleteLinkedTask);
-      if (isJsonOutput()) {
-        output(result);
-      } else {
-        console.log(`Deleted worktree: ${worktreePath}`);
-      }
-      break;
-    }
-    default:
-      throw new CliError("UNKNOWN_ACTION", `Unknown action: ${action}. Valid: list, delete`, ExitCodes.INVALID_ARGS);
-  }
-}
-
-// cli/src/commands/config.ts
-init_client();
-init_errors();
-async function handleConfigCommand(action, positional, flags) {
-  const client = new FulcrumClient(flags.url, flags.port);
-  switch (action) {
-    case "list": {
-      const config3 = await client.getAllConfig();
-      if (isJsonOutput()) {
-        output(config3);
-      } else {
-        console.log("Configuration:");
-        for (const [key, value] of Object.entries(config3)) {
-          const displayValue = value === null ? "(not set)" : value;
-          console.log(`  ${key}: ${displayValue}`);
-        }
-      }
-      break;
-    }
-    case "get": {
-      const [key] = positional;
-      if (!key) {
-        throw new CliError("MISSING_KEY", "Config key is required", ExitCodes.INVALID_ARGS);
-      }
-      const config3 = await client.getConfig(key);
-      if (isJsonOutput()) {
-        output(config3);
-      } else {
-        const value = config3.value === null ? "(not set)" : config3.value;
-        console.log(`${key}: ${value}`);
-      }
-      break;
-    }
-    case "set": {
-      const [key, value] = positional;
-      if (!key) {
-        throw new CliError("MISSING_KEY", "Config key is required", ExitCodes.INVALID_ARGS);
-      }
-      if (value === undefined) {
-        throw new CliError("MISSING_VALUE", "Config value is required", ExitCodes.INVALID_ARGS);
-      }
-      const parsedValue = /^\d+$/.test(value) ? parseInt(value, 10) : value;
-      const config3 = await client.setConfig(key, parsedValue);
-      if (isJsonOutput()) {
-        output(config3);
-      } else {
-        console.log(`Set ${key} = ${config3.value}`);
-      }
-      break;
-    }
-    case "reset": {
-      const [key] = positional;
-      if (!key) {
-        throw new CliError("MISSING_KEY", "Config key is required", ExitCodes.INVALID_ARGS);
-      }
-      const config3 = await client.resetConfig(key);
-      if (isJsonOutput()) {
-        output(config3);
-      } else {
-        console.log(`Reset ${key} to default: ${config3.value}`);
-      }
-      break;
-    }
-    default:
-      throw new CliError("UNKNOWN_ACTION", `Unknown action: ${action}. Valid: list, get, set, reset`, ExitCodes.INVALID_ARGS);
-  }
-}
-
-// cli/src/commands/opencode.ts
-init_errors();
-import {
-  mkdirSync as mkdirSync3,
-  writeFileSync as writeFileSync3,
-  existsSync as existsSync4,
-  readFileSync as readFileSync4,
-  unlinkSync as unlinkSync2,
-  copyFileSync,
-  renameSync
-} from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join4 } from "path";
-
-// plugins/fulcrum-opencode/index.ts
-var fulcrum_opencode_default = `import type { Plugin } from "@opencode-ai/plugin"
-import { appendFileSync } from "node:fs"
-import { spawn } from "node:child_process"
-import { tmpdir } from "node:os"
-import { join } from "node:path"
-
-declare const process: { env: Record<string, string | undefined> }
-
-const LOG_FILE = join(tmpdir(), "fulcrum-opencode.log")
-const NOISY_EVENTS = new Set([
-  "message.part.updated",
-  "file.watcher.updated",
-  "tui.toast.show",
-  "config.updated",
-])
-const log = (msg: string) => {
-  try {
-    appendFileSync(LOG_FILE, \`[\${new Date().toISOString()}] \${msg}\\n\`)
-  } catch {
-    // Silently ignore logging errors - logging is non-critical
-  }
-}
-
-/**
- * Execute fulcrum command using spawn with shell option for proper PATH resolution.
- * Using spawn with explicit args array prevents shell injection while shell:true
- * ensures PATH is properly resolved (for NVM, fnm, etc. managed node installations).
- * Includes 10 second timeout protection to prevent hanging.
- */
-async function runFulcrumCommand(args: string[]): Promise<{ exitCode: number; stdout: string; stderr: string }> {
-  return new Promise((resolve) => {
-    let stdout = ''
-    let stderr = ''
-    let resolved = false
-    let processExited = false
-    let killTimeoutId: ReturnType<typeof setTimeout> | null = null
-
-    const child = spawn(FULCRUM_CMD, args, { shell: true })
-
-    const cleanup = () => {
-      processExited = true
-      if (killTimeoutId) {
-        clearTimeout(killTimeoutId)
-        killTimeoutId = null
-      }
-    }
-
-    child.stdout?.on('data', (data) => {
-      stdout += data.toString()
-    })
-
-    child.stderr?.on('data', (data) => {
-      stderr += data.toString()
-    })
-
-    child.on('close', (code) => {
-      cleanup()
-      if (!resolved) {
-        resolved = true
-        resolve({ exitCode: code || 0, stdout, stderr })
-      }
-    })
-
-    child.on('error', (err) => {
-      cleanup()
-      if (!resolved) {
-        resolved = true
-        resolve({ exitCode: 1, stdout, stderr: err.message || '' })
-      }
-    })
-
-    // Add timeout protection to prevent hanging
-    const timeoutId = setTimeout(() => {
-      if (!resolved) {
-        resolved = true
-        log(\`Command timeout: \${FULCRUM_CMD} \${args.join(' ')}\`)
-        child.kill('SIGTERM')
-        // Schedule SIGKILL if process doesn't exit after SIGTERM
-        killTimeoutId = setTimeout(() => {
-          if (!processExited) {
-            log(\`Process didn't exit after SIGTERM, sending SIGKILL\`)
-            child.kill('SIGKILL')
-          }
-        }, 2000)
-        resolve({ exitCode: -1, stdout, stderr: \`Command timed out after \${FULCRUM_COMMAND_TIMEOUT_MS}ms\` })
-      }
-    }, FULCRUM_COMMAND_TIMEOUT_MS)
-
-    // Clear timeout if command completes
-    child.on('exit', () => clearTimeout(timeoutId))
-  })
-}
-
-let mainSessionId: string | null = null
-const subagentSessions = new Set<string>()
-let pendingIdleTimer: ReturnType<typeof setTimeout> | null = null
-let activityVersion = 0
-let lastStatus: "in-progress" | "review" | "" = ""
-
-const FULCRUM_CMD = "fulcrum"
-const IDLE_CONFIRMATION_DELAY_MS = 1500
-const FULCRUM_COMMAND_TIMEOUT_MS = 10000
-const STATUS_CHANGE_DEBOUNCE_MS = 500
-
-let deferredContextCheck: Promise<boolean> | null = null
-let isFulcrumContext: boolean | null = null
-let pendingStatusCommand: Promise<{ exitCode: number; stdout: string; stderr: string }> | null = null
-
-export const FulcrumPlugin: Plugin = async ({ $, directory }) => {
-  log("Plugin initializing...")
-
-  if (process.env.FULCRUM_TASK_ID) {
-    isFulcrumContext = true
-    log("Fulcrum context detected via env var")
-  } else {
-    deferredContextCheck = Promise.all([
-      $\`\${FULCRUM_CMD} --version\`.quiet().nothrow().text(),
-      runFulcrumCommand(['current-task', '--path', directory]),
-    ])
-      .then(([versionResult, taskResult]) => {
-        if (!versionResult) {
-          log("Fulcrum CLI not found")
-          return false
-        }
-        const inContext = taskResult.exitCode === 0
-        log(inContext ? "Fulcrum context active" : "Not a Fulcrum context")
-        return inContext
-      })
-      .catch(() => {
-        log("Fulcrum check failed")
-        return false
-      })
-  }
-
-  log("Plugin hooks registered")
-
-  const checkContext = async (): Promise<boolean> => {
-    if (isFulcrumContext !== null) return isFulcrumContext
-    if (deferredContextCheck) {
-      isFulcrumContext = await deferredContextCheck
-      deferredContextCheck = null
-      return isFulcrumContext
-    }
-    return false
-  }
-
-  const cancelPendingIdle = () => {
-    if (pendingIdleTimer) {
-      clearTimeout(pendingIdleTimer)
-      pendingIdleTimer = null
-      log("Cancelled pending idle transition")
-    }
-  }
-
-  const setStatus = (status: "in-progress" | "review") => {
-    if (status === lastStatus) return
-
-    cancelPendingIdle()
-
-    if (pendingStatusCommand) {
-      log(\`Status change already in progress, will retry after \${STATUS_CHANGE_DEBOUNCE_MS}ms\`)
-      setTimeout(() => setStatus(status), STATUS_CHANGE_DEBOUNCE_MS)
-      return
-    }
-
-    lastStatus = status
-
-    ;(async () => {
-      try {
-        log(\`Setting status: \${status}\`)
-        pendingStatusCommand = runFulcrumCommand(['current-task', status, '--path', directory])
-        const res = await pendingStatusCommand
-        pendingStatusCommand = null
-
-        if (res.exitCode !== 0) {
-          log(\`Status update failed: exitCode=\${res.exitCode}, stderr=\${res.stderr}\`)
-        }
-      } catch (e) {
-        log(\`Status update error: \${e}\`)
-        pendingStatusCommand = null
-      }
-    })()
-  }
-
-  const scheduleIdleTransition = () => {
-    cancelPendingIdle()
-    const currentVersion = ++activityVersion
-
-    pendingIdleTimer = setTimeout(() => {
-      if (activityVersion !== currentVersion) {
-        log(
-          \`Stale idle transition (version \${currentVersion} vs \${activityVersion})\`,
-        )
-        return
-      }
-      setStatus("review")
-    }, IDLE_CONFIRMATION_DELAY_MS)
-
-    log(
-      \`Scheduled idle transition (version \${currentVersion}, delay \${IDLE_CONFIRMATION_DELAY_MS}ms)\`,
-    )
-  }
-
-  const recordActivity = (reason: string) => {
-    activityVersion++
-    cancelPendingIdle()
-    log(\`Activity: \${reason} (version now \${activityVersion})\`)
-  }
-
-  return {
-    "chat.message": async (_input, output) => {
-      if (!(await checkContext())) return
-
-      if (output.message.role === "user") {
-        recordActivity("user message")
-        setStatus("in-progress")
-      } else if (output.message.role === "assistant") {
-        recordActivity("assistant message")
-      }
-    },
-
-    event: async ({ event }) => {
-      if (!NOISY_EVENTS.has(event.type)) {
-        log(\`Event: \${event.type}\`)
-      }
-
-      if (!(await checkContext())) return
-
-      const props = (event.properties as Record<string, unknown>) || {}
-
-      if (event.type === "session.created") {
-        const info = (props.info as Record<string, unknown>) || {}
-        const sessionId = info.id as string | undefined
-        const parentId = info.parentID as string | undefined
-
-        if (parentId) {
-          if (sessionId) subagentSessions.add(sessionId)
-          log(\`Subagent session tracked: \${sessionId} (parent: \${parentId})\`)
-        } else if (!mainSessionId && sessionId) {
-          mainSessionId = sessionId
-          log(\`Main session set: \${mainSessionId}\`)
-        }
-
-        recordActivity("session.created")
-        setStatus("in-progress")
-        return
-      }
-
-      const status = props.status as Record<string, unknown> | undefined
-      if (
-        (event.type === "session.status" && status?.type === "busy") ||
-        event.type.startsWith("tool.execute")
-      ) {
-        recordActivity(event.type)
-        return
-      }
-
-      if (
-        event.type === "session.idle" ||
-        (event.type === "session.status" && status?.type === "idle")
-      ) {
-        const info = (props.info as Record<string, unknown>) || {}
-        const sessionId =
-          (props.sessionID as string) || (info.id as string) || null
-
-        if (sessionId && subagentSessions.has(sessionId)) {
-          log(\`Ignoring subagent idle: \${sessionId}\`)
-          return
-        }
-
-        if (mainSessionId && sessionId && sessionId !== mainSessionId) {
-          log(\`Ignoring non-main idle: \${sessionId} (main: \${mainSessionId})\`)
-          return
-        }
-
-        log(\`Main session idle detected: \${sessionId}\`)
-        scheduleIdleTransition()
-      }
-    },
-  }
-}
-`;
-
-// cli/src/commands/opencode.ts
-var OPENCODE_DIR = join4(homedir2(), ".opencode");
-var OPENCODE_CONFIG_PATH = join4(OPENCODE_DIR, "opencode.json");
-var PLUGIN_DIR = join4(homedir2(), ".config", "opencode", "plugin");
-var PLUGIN_PATH = join4(PLUGIN_DIR, "fulcrum.ts");
-var FULCRUM_MCP_CONFIG = {
-  type: "local",
-  command: ["fulcrum", "mcp"],
-  enabled: true
-};
-async function handleOpenCodeCommand(action) {
-  if (action === "install") {
-    await installOpenCodeIntegration();
-    return;
-  }
-  if (action === "uninstall") {
-    await uninstallOpenCodeIntegration();
-    return;
-  }
-  throw new CliError("INVALID_ACTION", "Unknown action. Usage: fulcrum opencode install | fulcrum opencode uninstall", ExitCodes.INVALID_ARGS);
-}
-async function installOpenCodeIntegration() {
-  try {
-    console.log("Installing OpenCode plugin...");
-    mkdirSync3(PLUGIN_DIR, { recursive: true });
-    writeFileSync3(PLUGIN_PATH, fulcrum_opencode_default, "utf-8");
-    console.log("\u2713 Installed plugin at " + PLUGIN_PATH);
-    console.log("Configuring MCP server...");
-    const mcpConfigured = addMcpServer();
-    console.log("");
-    if (mcpConfigured) {
-      console.log("Installation complete! Restart OpenCode to apply changes.");
-    } else {
-      console.log("Plugin installed, but MCP configuration was skipped.");
-      console.log("Please add the MCP server manually (see above).");
-    }
-  } catch (err) {
-    throw new CliError("INSTALL_FAILED", `Failed to install OpenCode integration: ${err instanceof Error ? err.message : String(err)}`, ExitCodes.ERROR);
-  }
-}
-async function uninstallOpenCodeIntegration() {
-  try {
-    let removedPlugin = false;
-    let removedMcp = false;
-    if (existsSync4(PLUGIN_PATH)) {
-      unlinkSync2(PLUGIN_PATH);
-      console.log("\u2713 Removed plugin from " + PLUGIN_PATH);
-      removedPlugin = true;
-    } else {
-      console.log("\u2022 Plugin not found (already removed)");
-    }
-    removedMcp = removeMcpServer();
-    if (!removedPlugin && !removedMcp) {
-      console.log("Nothing to uninstall.");
-    } else {
-      console.log("");
-      console.log("Uninstall complete! Restart OpenCode to apply changes.");
-    }
-  } catch (err) {
-    throw new CliError("UNINSTALL_FAILED", `Failed to uninstall OpenCode integration: ${err instanceof Error ? err.message : String(err)}`, ExitCodes.ERROR);
-  }
-}
-function getMcpObject(config3) {
-  const mcp = config3.mcp;
-  if (mcp && typeof mcp === "object" && !Array.isArray(mcp)) {
-    return mcp;
-  }
-  return {};
-}
-function addMcpServer() {
-  mkdirSync3(OPENCODE_DIR, { recursive: true });
-  let config3 = {};
-  if (existsSync4(OPENCODE_CONFIG_PATH)) {
-    try {
-      const content = readFileSync4(OPENCODE_CONFIG_PATH, "utf-8");
-      config3 = JSON.parse(content);
-    } catch {
-      console.log("\u26A0 Could not parse existing opencode.json, skipping MCP configuration");
-      console.log("  Add manually to ~/.opencode/opencode.json:");
-      console.log('    "mcp": { "fulcrum": { "type": "local", "command": ["fulcrum", "mcp"], "enabled": true } }');
-      return false;
-    }
-  }
-  const mcp = getMcpObject(config3);
-  if (mcp.fulcrum) {
-    console.log("\u2022 MCP server already configured, preserving existing configuration");
-    return true;
-  }
-  if (existsSync4(OPENCODE_CONFIG_PATH)) {
-    copyFileSync(OPENCODE_CONFIG_PATH, OPENCODE_CONFIG_PATH + ".backup");
-  }
-  config3.mcp = {
-    ...mcp,
-    fulcrum: FULCRUM_MCP_CONFIG
-  };
-  const tempPath = OPENCODE_CONFIG_PATH + ".tmp";
-  try {
-    writeFileSync3(tempPath, JSON.stringify(config3, null, 2), "utf-8");
-    renameSync(tempPath, OPENCODE_CONFIG_PATH);
-  } catch (error46) {
-    try {
-      if (existsSync4(tempPath)) {
-        unlinkSync2(tempPath);
-      }
-    } catch {}
-    throw error46;
-  }
-  console.log("\u2713 Added MCP server to " + OPENCODE_CONFIG_PATH);
-  return true;
-}
-function removeMcpServer() {
-  if (!existsSync4(OPENCODE_CONFIG_PATH)) {
-    console.log("\u2022 MCP config not found (already removed)");
-    return false;
-  }
-  let config3;
-  try {
-    const content = readFileSync4(OPENCODE_CONFIG_PATH, "utf-8");
-    config3 = JSON.parse(content);
-  } catch {
-    console.log("\u26A0 Could not parse opencode.json, skipping MCP removal");
-    return false;
-  }
-  const mcp = getMcpObject(config3);
-  if (!mcp.fulcrum) {
-    console.log("\u2022 MCP server not configured (already removed)");
-    return false;
-  }
-  copyFileSync(OPENCODE_CONFIG_PATH, OPENCODE_CONFIG_PATH + ".backup");
-  delete mcp.fulcrum;
-  if (Object.keys(mcp).length === 0) {
-    delete config3.mcp;
-  } else {
-    config3.mcp = mcp;
-  }
-  const tempPath = OPENCODE_CONFIG_PATH + ".tmp";
-  try {
-    writeFileSync3(tempPath, JSON.stringify(config3, null, 2), "utf-8");
-    renameSync(tempPath, OPENCODE_CONFIG_PATH);
-  } catch (error46) {
-    try {
-      if (existsSync4(tempPath)) {
-        unlinkSync2(tempPath);
-      }
-    } catch {}
-    throw error46;
-  }
-  console.log("\u2713 Removed MCP server from " + OPENCODE_CONFIG_PATH);
-  return true;
-}
-
-// cli/src/commands/claude.ts
-init_errors();
-import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync4, existsSync as existsSync5, rmSync } from "fs";
-import { homedir as homedir3 } from "os";
-import { join as join5 } from "path";
-
-// plugins/fulcrum/.claude-plugin/plugin.json
-var plugin_default = `{
-  "name": "fulcrum",
-  "description": "Fulcrum task orchestration for Claude Code",
-  "version": "1.3.0",
-  "author": {
-    "name": "Fulcrum"
-  },
-  "hooks": "./hooks/hooks.json"
-}
-`;
-
-// plugins/fulcrum/hooks/hooks.json
-var hooks_default = `{
-  "hooks": {
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "fulcrum current-task review 2>/dev/null || true"
-          }
-        ]
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "fulcrum current-task in-progress 2>/dev/null || true"
-          }
-        ]
-      }
-    ]
-  }
-}
-`;
-
-// plugins/fulcrum/mcp.json
-var mcp_default = `{
-  "mcpServers": {
-    "fulcrum": {
-      "command": "fulcrum",
-      "args": ["mcp"]
+    ]
+  }
+}
+`;
+
+// plugins/fulcrum/.mcp.json
+var _mcp_default = `{
+  "mcpServers": {
+    "fulcrum": {
+      "command": "fulcrum",
+      "args": ["mcp"]
     }
   }
 }
@@ -49016,38 +48193,25 @@ Send a notification: \`fulcrum notify $ARGUMENTS\`
 Format: fulcrum notify "Title" "Message body"
 `;
 
-// plugins/fulcrum/commands/linear.md
-var linear_default = `---
-description: Link a Linear ticket to the current fulcrum task
----
-Link the Linear ticket to this task: \`fulcrum current-task linear $ARGUMENTS\`
-`;
-
-// plugins/fulcrum/commands/review.md
-var review_default = `---
-description: Mark the current fulcrum task as ready for review
----
-Mark this task ready for review: \`fulcrum current-task review\`
-
-This sends a notification to the user.
-`;
-
-// plugins/fulcrum/skills/vibora/SKILL.md
+// plugins/fulcrum/skills/fulcrum/SKILL.md
 var SKILL_default = `---
 name: fulcrum
-description: Fulcrum is a terminal-first tool for orchestrating AI coding agents across isolated git worktrees. Use this skill when working in a Fulcrum task worktree or managing tasks.
+description: AI orchestration and task management platform. Use this skill when working in a Fulcrum task worktree, managing tasks/projects, or interacting with the Fulcrum server.
 ---
 
-# Fulcrum - AI Agent Orchestration
+# Fulcrum - AI Orchestration Platform
 
 ## Overview
 
-Fulcrum is a terminal-first tool for orchestrating AI coding agents (like Claude Code) across isolated git worktrees. Each task runs in its own worktree, enabling parallel work on multiple features or fixes without branch switching.
+Fulcrum is an AI orchestration and task management platform. It provides task tracking, project management, and tools for AI agents to work autonomously across isolated git worktrees.
 
-**Philosophy:**
-- Agents run natively in terminals - no abstraction layer or wrapper APIs
-- Tasks create isolated git worktrees for clean separation
-- Persistent terminals organized in tabs across tasks
+**Key Features:**
+- Task management with kanban boards and status tracking
+- Project and repository organization
+- Git worktree isolation for parallel development
+- Docker Compose app deployment
+- Multi-channel notifications
+- MCP tools for AI agent integration
 
 ## When to Use This Skill
 
@@ -49055,9 +48219,9 @@ Use the Fulcrum CLI when:
 - **Working in a task worktree** - Use \`current-task\` commands to manage your current task
 - **Updating task status** - Mark tasks as in-progress, ready for review, done, or canceled
 - **Linking PRs** - Associate a GitHub PR with the current task
-- **Linking Linear tickets** - Connect a Linear issue to the current task
 - **Linking URLs** - Attach any relevant URLs (design docs, specs, external resources) to the task
 - **Sending notifications** - Alert the user when work is complete or needs attention
+- **Managing projects and repositories** - Create, update, and organize projects
 
 Use the Fulcrum MCP tools when:
 - **Executing commands remotely** - Run shell commands on the Fulcrum server from Claude Desktop
@@ -49070,7 +48234,7 @@ Use the Fulcrum MCP tools when:
 When running inside a Fulcrum task worktree, use these commands to manage the current task:
 
 \`\`\`bash
-# Get current task info (JSON output)
+# Get current task info (comprehensive output with dependencies, attachments, etc.)
 fulcrum current-task
 
 # Update task status
@@ -49107,7 +48271,7 @@ fulcrum tasks list --label="bug"          # Filter by label
 fulcrum tasks labels                      # Show all labels with counts
 fulcrum tasks labels --search="comm"      # Find labels matching substring
 
-# Get a specific task
+# Get a specific task (includes dependencies and attachments)
 fulcrum tasks get <task-id>
 
 # Create a new task
@@ -49122,6 +48286,25 @@ fulcrum tasks move <task-id> --status=IN_REVIEW
 # Delete a task
 fulcrum tasks delete <task-id>
 fulcrum tasks delete <task-id> --delete-worktree   # Also delete worktree
+
+# Labels
+fulcrum tasks add-label <task-id> <label>
+fulcrum tasks remove-label <task-id> <label>
+
+# Due dates
+fulcrum tasks set-due-date <task-id> 2026-01-25     # Set due date
+fulcrum tasks set-due-date <task-id> none          # Clear due date
+
+# Dependencies
+fulcrum tasks add-dependency <task-id> <depends-on-task-id>
+fulcrum tasks remove-dependency <task-id> <dependency-id>
+fulcrum tasks list-dependencies <task-id>
+
+# Attachments
+fulcrum tasks attachments list <task-id>
+fulcrum tasks attachments upload <task-id> <file-path>
+fulcrum tasks attachments delete <task-id> <attachment-id>
+fulcrum tasks attachments path <task-id> <attachment-id>   # Get local file path
 \`\`\`
 
 ### notifications
@@ -49155,7 +48338,28 @@ fulcrum notifications set slack webhookUrl <url>
 fulcrum up          # Start Fulcrum server daemon
 fulcrum down        # Stop Fulcrum server
 fulcrum status      # Check if server is running
-fulcrum health      # Check server health
+fulcrum doctor      # Check all dependencies and versions
+\`\`\`
+
+### Configuration
+
+\`\`\`bash
+fulcrum config list              # List all config values
+fulcrum config get <key>         # Get a specific value
+fulcrum config set <key> <value> # Set a value
+fulcrum config reset <key>       # Reset to default
+\`\`\`
+
+### Agent Plugin Installation
+
+\`\`\`bash
+# Claude Code integration
+fulcrum claude install       # Install Fulcrum plugin for Claude Code
+fulcrum claude uninstall     # Uninstall plugin
+
+# OpenCode integration
+fulcrum opencode install     # Install Fulcrum plugin for OpenCode
+fulcrum opencode uninstall   # Uninstall plugin
 \`\`\`
 
 ### Git Operations
@@ -49163,7 +48367,15 @@ fulcrum health      # Check server health
 \`\`\`bash
 fulcrum git status              # Git status for current worktree
 fulcrum git diff                # Git diff for current worktree
+fulcrum git diff --staged       # Show staged changes only
+fulcrum git branches --repo=/path/to/repo   # List branches
+\`\`\`
+
+### Worktrees
+
+\`\`\`bash
 fulcrum worktrees list          # List all worktrees
+fulcrum worktrees delete --path=/path/to/worktree   # Delete a worktree
 \`\`\`
 
 ### projects
@@ -49316,302 +48528,1434 @@ fulcrum fs stat --path=/path/to/check
 4. **Ready for Review**: Agent marks complete: \`fulcrum current-task review\`
 5. **Notification**: User receives notification that work is ready
 
-### Linking External Resources
+### Linking External Resources
+
+\`\`\`bash
+# After creating a GitHub PR
+fulcrum current-task pr https://github.com/owner/repo/pull/123
+
+# After identifying the relevant Linear ticket
+fulcrum current-task linear https://linear.app/team/issue/TEAM-123
+
+# Add any URL link (design docs, figma, notion, external resources)
+fulcrum current-task link https://figma.com/file/abc123/design
+fulcrum current-task link https://notion.so/team/spec --label "Product Spec"
+\`\`\`
+
+### Notifying the User
+
+\`\`\`bash
+# When work is complete
+fulcrum notify "Task Complete" "Implemented the new feature and created PR #123"
+
+# When blocked or need input
+fulcrum notify "Need Input" "Which approach should I use for the database migration?"
+\`\`\`
+
+## Global Options
+
+These flags work with most commands:
+
+- \`--port=<port>\` - Server port (default: 7777)
+- \`--url=<url>\` - Override full server URL
+- \`--json\` - Output as JSON for programmatic use
+
+## Task Statuses
+
+- \`TO_DO\` - Task not yet started
+- \`IN_PROGRESS\` - Task is being worked on
+- \`IN_REVIEW\` - Task is complete and awaiting review
+- \`DONE\` - Task is finished
+- \`CANCELED\` - Task was abandoned
+
+## MCP Tools
+
+Fulcrum provides a comprehensive set of MCP tools for AI agents. Use \`search_tools\` to discover available tools.
+
+### Tool Discovery
+
+#### search_tools
+
+Search for available tools by keyword or category:
+
+\`\`\`json
+{
+  "query": "deploy",      // Optional: Search term
+  "category": "apps"      // Optional: Filter by category
+}
+\`\`\`
+
+**Categories:** core, tasks, projects, repositories, apps, filesystem, git, notifications, exec
+
+**Example Usage:**
+\`\`\`
+search_tools { query: "project create" }
+\u2192 Returns tools for creating projects
+
+search_tools { category: "filesystem" }
+\u2192 Returns all filesystem tools
+\`\`\`
+
+### Task Tools
+
+- \`list_tasks\` - List tasks with flexible filtering (search, labels, statuses, date range, overdue)
+- \`get_task\` - Get task details by ID (includes dependencies and attachments)
+- \`create_task\` - Create a new task with worktree
+- \`update_task\` - Update task metadata
+- \`delete_task\` - Delete a task
+- \`move_task\` - Move task to different status
+- \`add_task_link\` - Add URL link to task
+- \`remove_task_link\` - Remove link from task
+- \`list_task_links\` - List all task links
+- \`add_task_tag\` - Add a label to a task (returns similar labels to catch typos)
+- \`remove_task_tag\` - Remove a label from a task
+- \`set_task_due_date\` - Set or clear task due date
+- \`list_tags\` - List all unique labels in use with optional search
+
+#### Task Dependencies
+
+- \`get_task_dependencies\` - Get dependencies and dependents of a task, and whether it is blocked
+- \`add_task_dependency\` - Add a dependency (task cannot start until dependency is done)
+- \`remove_task_dependency\` - Remove a dependency
+- \`get_task_dependency_graph\` - Get all tasks and dependencies as a graph for visualization
+
+#### Task Attachments
+
+- \`list_task_attachments\` - List all file attachments for a task
+- \`upload_task_attachment\` - Upload a file to a task from a local path
+- \`delete_task_attachment\` - Delete a file attachment from a task
+- \`get_task_attachment_path\` - Get the local file path for a task attachment
+
+#### Task Search and Filtering
+
+The \`list_tasks\` tool supports powerful filtering for AI agents:
+
+\`\`\`json
+{
+  "search": "ocai",                              // Text search across title, labels, project name
+  "labels": ["bug", "urgent"],                   // Filter by multiple labels (OR logic)
+  "statuses": ["TO_DO", "IN_PROGRESS"],          // Filter by multiple statuses (OR logic)
+  "dueDateStart": "2026-01-18",                  // Start of date range
+  "dueDateEnd": "2026-01-25",                    // End of date range
+  "overdue": true                                // Only show overdue tasks
+}
+\`\`\`
+
+#### Label Discovery
+
+Use \`list_labels\` to discover exact label names before filtering:
+
+\`\`\`json
+// Find labels matching "communication"
+{ "search": "communication" }
+// Returns: [{ "name": "communication required", "count": 5 }]
+\`\`\`
+
+This helps handle typos and variations - search first, then use the exact label name.
+
+### Project Tools
+
+- \`list_projects\` - List all projects
+- \`get_project\` - Get project details
+- \`create_project\` - Create from path, URL, or existing repo
+- \`update_project\` - Update name, description, status
+- \`delete_project\` - Delete project and optionally directory/app
+- \`scan_projects\` - Scan directory for git repos
+
+#### Project Tags
+
+- \`add_project_tag\` - Add a tag to a project (creates new if needed)
+- \`remove_project_tag\` - Remove a tag from a project
+
+#### Project Attachments
+
+- \`list_project_attachments\` - List all file attachments for a project
+- \`upload_project_attachment\` - Upload a file to a project from a local path
+- \`delete_project_attachment\` - Delete a file attachment from a project
+- \`get_project_attachment_path\` - Get the local file path for a project attachment
+
+#### Project Links
+
+- \`list_project_links\` - List all URL links attached to a project
+- \`add_project_link\` - Add a URL link to a project (auto-detects type)
+- \`remove_project_link\` - Remove a URL link from a project
+
+### Repository Tools
+
+- \`list_repositories\` - List all repositories (supports orphans filter)
+- \`get_repository\` - Get repository details by ID
+- \`add_repository\` - Add repository from local path
+- \`update_repository\` - Update repository metadata (name, agent, startup script)
+- \`delete_repository\` - Delete orphaned repository (fails if linked to project)
+- \`link_repository_to_project\` - Link repo to project (errors if already linked elsewhere)
+- \`unlink_repository_from_project\` - Unlink repo from project
+
+### App/Deployment Tools
+
+- \`list_apps\` - List all deployed apps
+- \`get_app\` - Get app details with services
+- \`create_app\` - Create app for deployment
+- \`deploy_app\` - Trigger deployment
+- \`stop_app\` - Stop running app
+- \`get_app_logs\` - Get container logs
+- \`get_app_status\` - Get container status
+- \`list_deployments\` - Get deployment history
+- \`delete_app\` - Delete app
+
+### Filesystem Tools
+
+Remote filesystem tools for working with files on the Fulcrum server. Useful when the agent runs on a different machine than the server (e.g., via SSH tunneling to Claude Desktop).
+
+- \`list_directory\` - List directory contents
+- \`get_file_tree\` - Get recursive file tree
+- \`read_file\` - Read file contents (secured)
+- \`write_file\` - Write entire file content (secured)
+- \`edit_file\` - Edit file by replacing a unique string (secured)
+- \`file_stat\` - Get file/directory metadata
+- \`is_git_repo\` - Check if directory is git repo
+
+### Command Execution
+
+When using Claude Desktop with Fulcrum's MCP server, you can execute commands on the remote Fulcrum server. This is useful when connecting to Fulcrum via SSH port forwarding.
+
+#### execute_command
+
+Execute shell commands with optional persistent session support:
+
+\`\`\`json
+{
+  "command": "echo hello world",
+  "sessionId": "optional-session-id",
+  "cwd": "/path/to/start",
+  "timeout": 30000,
+  "name": "my-session"
+}
+\`\`\`
+
+**Parameters:**
+- \`command\` (required) \u2014 The shell command to execute
+- \`sessionId\` (optional) \u2014 Reuse a session to preserve env vars, cwd, and shell state
+- \`cwd\` (optional) \u2014 Initial working directory (only used when creating new session)
+- \`timeout\` (optional) \u2014 Timeout in milliseconds (default: 30000)
+- \`name\` (optional) \u2014 Session name for identification (only used when creating new session)
+
+**Response:**
+\`\`\`json
+{
+  "sessionId": "uuid",
+  "stdout": "hello world",
+  "stderr": "",
+  "exitCode": 0,
+  "timedOut": false
+}
+\`\`\`
+
+### Session Workflow Example
+
+\`\`\`
+1. First command (creates named session):
+   execute_command { command: "cd /project && export API_KEY=secret", name: "dev-session" }
+   \u2192 Returns sessionId: "abc-123"
+
+2. Subsequent commands (reuse session):
+   execute_command { command: "echo $API_KEY", sessionId: "abc-123" }
+   \u2192 Returns stdout: "secret" (env var preserved)
+
+   execute_command { command: "pwd", sessionId: "abc-123" }
+   \u2192 Returns stdout: "/project" (cwd preserved)
+
+3. Rename session if needed:
+   update_exec_session { sessionId: "abc-123", name: "new-name" }
+
+4. Cleanup when done:
+   destroy_exec_session { sessionId: "abc-123" }
+\`\`\`
+
+Sessions persist until manually destroyed.
+
+### list_exec_sessions
+
+List all active sessions with their name, current working directory, and timestamps.
+
+### update_exec_session
+
+Rename an existing session for identification.
+
+### destroy_exec_session
 
-\`\`\`bash
-# After creating a GitHub PR
-fulcrum current-task pr https://github.com/owner/repo/pull/123
+Clean up a session when you're done to free resources.
 
-# After identifying the relevant Linear ticket
-fulcrum current-task linear https://linear.app/team/issue/TEAM-123
+## Best Practices
 
-# Add any URL link (design docs, figma, notion, external resources)
-fulcrum current-task link https://figma.com/file/abc123/design
-fulcrum current-task link https://notion.so/team/spec --label "Product Spec"
-\`\`\`
+1. **Use \`current-task\` inside worktrees** - It auto-detects which task you're in
+2. **Link PRs immediately** - Run \`fulcrum current-task pr <url>\` right after creating a PR
+3. **Link relevant resources** - Attach design docs, specs, or reference materials with \`fulcrum current-task link <url>\`
+4. **Mark review when done** - \`fulcrum current-task review\` notifies the user
+5. **Send notifications for blocking issues** - Keep the user informed of progress
+6. **Name sessions for identification** - Use descriptive names to find sessions later
+7. **Reuse sessions for related commands** - Preserve state across multiple execute_command calls
+8. **Clean up sessions when done** - Use destroy_exec_session to free resources
+`;
 
-### Notifying the User
+// cli/src/commands/claude.ts
+var MARKETPLACE_DIR = join3(homedir2(), ".fulcrum", "claude-plugin");
+var MARKETPLACE_NAME = "fulcrum";
+var PLUGIN_NAME = "fulcrum";
+var PLUGIN_ID = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
+var PLUGIN_FILES = [
+  { path: ".claude-plugin/marketplace.json", content: marketplace_default },
+  { path: "hooks/hooks.json", content: hooks_default },
+  { path: ".mcp.json", content: _mcp_default },
+  { path: "commands/pr.md", content: pr_default },
+  { path: "commands/task-info.md", content: task_info_default },
+  { path: "commands/notify.md", content: notify_default },
+  { path: "skills/fulcrum/SKILL.md", content: SKILL_default }
+];
+var LEGACY_PLUGIN_DIR = join3(homedir2(), ".claude", "plugins", "fulcrum");
+var LEGACY_CACHE_DIR = join3(homedir2(), ".claude", "plugins", "cache", "fulcrum");
+function runClaude(args) {
+  const result = spawnSync2("claude", args, { encoding: "utf-8" });
+  return {
+    success: result.status === 0,
+    output: (result.stdout || "") + (result.stderr || "")
+  };
+}
+function getBundledVersion() {
+  try {
+    const parsed = JSON.parse(marketplace_default);
+    return parsed.plugins?.[0]?.version || "1.0.0";
+  } catch {
+    return "1.0.0";
+  }
+}
+function getInstalledVersion() {
+  const installedMarketplace = join3(MARKETPLACE_DIR, ".claude-plugin", "marketplace.json");
+  if (!existsSync3(installedMarketplace)) {
+    return null;
+  }
+  try {
+    const installed = JSON.parse(readFileSync4(installedMarketplace, "utf-8"));
+    return installed.plugins?.[0]?.version || null;
+  } catch {
+    return null;
+  }
+}
+async function handleClaudeCommand(action) {
+  if (action === "install") {
+    await installClaudePlugin();
+    return;
+  }
+  if (action === "uninstall") {
+    await uninstallClaudePlugin();
+    return;
+  }
+  throw new CliError("INVALID_ACTION", "Unknown action. Usage: fulcrum claude install | fulcrum claude uninstall", ExitCodes.INVALID_ARGS);
+}
+function needsPluginUpdate() {
+  const installedVersion = getInstalledVersion();
+  if (!installedVersion) {
+    return true;
+  }
+  const bundledVersion = getBundledVersion();
+  return installedVersion !== bundledVersion;
+}
+async function installClaudePlugin(options = {}) {
+  const { silent = false } = options;
+  const log = silent ? () => {} : console.log;
+  try {
+    log("Installing Claude Code plugin...");
+    if (existsSync3(MARKETPLACE_DIR)) {
+      rmSync(MARKETPLACE_DIR, { recursive: true });
+    }
+    for (const file2 of PLUGIN_FILES) {
+      const fullPath = join3(MARKETPLACE_DIR, file2.path);
+      mkdirSync3(dirname2(fullPath), { recursive: true });
+      writeFileSync3(fullPath, file2.content, "utf-8");
+    }
+    log("\u2713 Created plugin files at " + MARKETPLACE_DIR);
+    runClaude(["plugin", "marketplace", "remove", MARKETPLACE_NAME]);
+    const addResult = runClaude(["plugin", "marketplace", "add", MARKETPLACE_DIR]);
+    if (!addResult.success) {
+      throw new Error("Failed to add marketplace: " + addResult.output);
+    }
+    log("\u2713 Registered marketplace");
+    const installResult = runClaude(["plugin", "install", PLUGIN_ID, "--scope", "user"]);
+    if (!installResult.success) {
+      throw new Error("Failed to install plugin: " + installResult.output);
+    }
+    log("\u2713 Installed plugin");
+    cleanupLegacyPaths(log);
+    log("");
+    log("Installation complete! Restart Claude Code to apply changes.");
+  } catch (err) {
+    throw new CliError("INSTALL_FAILED", `Failed to install Claude plugin: ${err instanceof Error ? err.message : String(err)}`, ExitCodes.ERROR);
+  }
+}
+async function uninstallClaudePlugin() {
+  try {
+    runClaude(["plugin", "uninstall", PLUGIN_ID]);
+    console.log("\u2713 Uninstalled plugin");
+    runClaude(["plugin", "marketplace", "remove", MARKETPLACE_NAME]);
+    console.log("\u2713 Removed marketplace");
+    if (existsSync3(MARKETPLACE_DIR)) {
+      rmSync(MARKETPLACE_DIR, { recursive: true });
+      console.log("\u2713 Removed plugin files from " + MARKETPLACE_DIR);
+    }
+    cleanupLegacyPaths(console.log);
+    console.log("");
+    console.log("Uninstall complete! Restart Claude Code to apply changes.");
+  } catch (err) {
+    throw new CliError("UNINSTALL_FAILED", `Failed to uninstall Claude plugin: ${err instanceof Error ? err.message : String(err)}`, ExitCodes.ERROR);
+  }
+}
+function cleanupLegacyPaths(log) {
+  const legacyPaths = [LEGACY_PLUGIN_DIR, LEGACY_CACHE_DIR];
+  for (const path of legacyPaths) {
+    if (existsSync3(path)) {
+      rmSync(path, { recursive: true });
+      log("\u2713 Removed legacy files from " + path);
+    }
+  }
+}
+// package.json
+var package_default = {
+  name: "@knowsuchagency/fulcrum",
+  private: true,
+  version: "1.5.0",
+  description: "Harness Attention. Orchestrate Agents. Ship.",
+  license: "PolyForm-Perimeter-1.0.0",
+  type: "module",
+  scripts: {
+    dev: "vite --host",
+    "dev:server": "mkdir -p ~/.fulcrum && bun --watch server/index.ts",
+    build: "tsc -b && vite build",
+    start: "NODE_ENV=production bun server/index.ts",
+    lint: "eslint .",
+    preview: "vite preview",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:studio": "drizzle-kit studio"
+  },
+  dependencies: {
+    "@atlaskit/pragmatic-drag-and-drop": "^1.7.7",
+    "@atlaskit/pragmatic-drag-and-drop-hitbox": "^1.1.0",
+    "@azurity/pure-nerd-font": "^3.0.5",
+    "@base-ui/react": "^1.0.0",
+    "@dagrejs/dagre": "^1.1.8",
+    "@fontsource-variable/jetbrains-mono": "^5.2.8",
+    "@hono/node-server": "^1.19.7",
+    "@hono/node-ws": "^1.2.0",
+    "@hugeicons/core-free-icons": "^3.0.0",
+    "@hugeicons/react": "^1.1.3",
+    "@monaco-editor/react": "^4.7.0",
+    "@octokit/rest": "^22.0.1",
+    "@radix-ui/react-collapsible": "^1.1.12",
+    "@tailwindcss/vite": "^4.1.17",
+    "@tanstack/react-query": "^5.90.12",
+    "@tanstack/react-router": "^1.141.8",
+    "@uiw/react-markdown-preview": "^5.1.5",
+    "@xterm/addon-clipboard": "^0.2.0",
+    "@xterm/addon-fit": "^0.10.0",
+    "@xterm/addon-web-links": "^0.11.0",
+    "@xterm/xterm": "^5.5.0",
+    "bun-pty": "^0.4.2",
+    citty: "^0.1.6",
+    "class-variance-authority": "^0.7.1",
+    cloudflare: "^5.2.0",
+    clsx: "^2.1.1",
+    "date-fns": "^4.1.0",
+    "drizzle-orm": "^0.45.1",
+    "fancy-ansi": "^0.1.3",
+    glob: "^13.0.0",
+    hono: "^4.11.1",
+    i18next: "^25.7.3",
+    mobx: "^6.15.0",
+    "mobx-react-lite": "^4.1.1",
+    "mobx-state-tree": "^7.0.2",
+    "next-themes": "^0.4.6",
+    react: "^19.2.0",
+    "react-day-picker": "^9.13.0",
+    "react-dom": "^19.2.0",
+    "react-i18next": "^16.5.0",
+    "react-resizable-panels": "^4.0.11",
+    reactflow: "^11.11.4",
+    recharts: "2.15.4",
+    shadcn: "^3.6.2",
+    shiki: "^3.20.0",
+    sonner: "^2.0.7",
+    "tailwind-merge": "^3.4.0",
+    tailwindcss: "^4.1.17",
+    "tw-animate-css": "^1.4.0",
+    ws: "^8.18.3",
+    yaml: "^2.8.2"
+  },
+  devDependencies: {
+    "@eslint/js": "^9.39.1",
+    "@opencode-ai/plugin": "^1.1.8",
+    "@tailwindcss/typography": "^0.5.19",
+    "@tanstack/router-plugin": "^1.141.8",
+    "@types/bun": "^1.2.14",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@types/ws": "^8.18.1",
+    "@vitejs/plugin-react": "^5.1.1",
+    "drizzle-kit": "^0.31.8",
+    eslint: "^9.39.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    globals: "^16.5.0",
+    typescript: "~5.9.3",
+    "typescript-eslint": "^8.46.4",
+    vite: "^7.2.4"
+  }
+};
 
-\`\`\`bash
-# When work is complete
-fulcrum notify "Task Complete" "Implemented the new feature and created PR #123"
+// cli/src/commands/up.ts
+function getPackageRoot() {
+  const currentFile = fileURLToPath(import.meta.url);
+  let dir = dirname3(currentFile);
+  for (let i2 = 0;i2 < 5; i2++) {
+    if (existsSync4(join4(dir, "server", "index.js"))) {
+      return dir;
+    }
+    dir = dirname3(dir);
+  }
+  return dirname3(dirname3(dirname3(currentFile)));
+}
+async function handleUpCommand(flags) {
+  const autoYes = flags.yes === "true" || flags.y === "true";
+  if (needsViboraMigration()) {
+    const viboraDir = getLegacyViboraDir();
+    console.error(`
+Found existing Vibora data at ${viboraDir}`);
+    console.error('Run "fulcrum migrate-from-vibora" to copy your data to ~/.fulcrum');
+    console.error("");
+  }
+  if (!isBunInstalled()) {
+    const bunDep = getDependency("bun");
+    const method = getInstallMethod(bunDep);
+    console.error("Bun is required to run Fulcrum but is not installed.");
+    console.error("  Bun is the JavaScript runtime that powers Fulcrum.");
+    const shouldInstall = autoYes || await confirm(`Would you like to install bun via ${method}?`);
+    if (shouldInstall) {
+      const success2 = installBun();
+      if (!success2) {
+        throw new CliError("INSTALL_FAILED", "Failed to install bun", ExitCodes.ERROR);
+      }
+      console.error("Bun installed successfully!");
+    } else {
+      throw new CliError("MISSING_DEPENDENCY", `Bun is required. Install manually: ${getInstallCommand(bunDep)}`, ExitCodes.ERROR);
+    }
+  }
+  if (!isDtachInstalled()) {
+    const dtachDep = getDependency("dtach");
+    const method = getInstallMethod(dtachDep);
+    console.error("dtach is required for terminal persistence but is not installed.");
+    console.error("  dtach enables persistent terminal sessions that survive disconnects.");
+    const shouldInstall = autoYes || await confirm(`Would you like to install dtach via ${method}?`);
+    if (shouldInstall) {
+      const success2 = installDtach();
+      if (!success2) {
+        throw new CliError("INSTALL_FAILED", "Failed to install dtach", ExitCodes.ERROR);
+      }
+      console.error("dtach installed successfully!");
+    } else {
+      throw new CliError("MISSING_DEPENDENCY", `dtach is required. Install manually: ${getInstallCommand(dtachDep)}`, ExitCodes.ERROR);
+    }
+  }
+  if (!isUvInstalled()) {
+    const uvDep = getDependency("uv");
+    const method = getInstallMethod(uvDep);
+    console.error("uv is required but is not installed.");
+    console.error("  uv is a fast Python package manager used by Claude Code.");
+    const shouldInstall = autoYes || await confirm(`Would you like to install uv via ${method}?`);
+    if (shouldInstall) {
+      const success2 = installUv();
+      if (!success2) {
+        throw new CliError("INSTALL_FAILED", "Failed to install uv", ExitCodes.ERROR);
+      }
+      console.error("uv installed successfully!");
+    } else {
+      throw new CliError("MISSING_DEPENDENCY", `uv is required. Install manually: ${getInstallCommand(uvDep)}`, ExitCodes.ERROR);
+    }
+  }
+  if (isClaudeInstalled() && needsPluginUpdate()) {
+    console.error("Updating Fulcrum plugin for Claude Code...");
+    await installClaudePlugin({ silent: true });
+    console.error("\u2713 Fulcrum plugin updated");
+  }
+  const existingPid = readPid();
+  if (existingPid && isProcessRunning(existingPid)) {
+    console.error(`Fulcrum server is already running (PID: ${existingPid})`);
+    const shouldReplace = autoYes || await confirm("Would you like to stop it and start a new instance?");
+    if (shouldReplace) {
+      console.error("Stopping existing instance...");
+      process.kill(existingPid, "SIGTERM");
+      let attempts = 0;
+      while (attempts < 50 && isProcessRunning(existingPid)) {
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        attempts++;
+      }
+      if (isProcessRunning(existingPid)) {
+        process.kill(existingPid, "SIGKILL");
+      }
+      removePid();
+      console.error("Existing instance stopped.");
+    } else {
+      throw new CliError("ALREADY_RUNNING", `Server already running at http://localhost:${getPort(flags.port)}`, ExitCodes.ERROR);
+    }
+  }
+  const port = getPort(flags.port);
+  if (flags.port) {
+    updateSettingsPort(port);
+  }
+  const host = flags.host ? "0.0.0.0" : "localhost";
+  const packageRoot = getPackageRoot();
+  const serverPath = join4(packageRoot, "server", "index.js");
+  const platform2 = process.platform;
+  const arch = process.arch;
+  let ptyLibName;
+  if (platform2 === "darwin") {
+    ptyLibName = arch === "arm64" ? "librust_pty_arm64.dylib" : "librust_pty.dylib";
+  } else if (platform2 === "win32") {
+    ptyLibName = "rust_pty.dll";
+  } else {
+    ptyLibName = arch === "arm64" ? "librust_pty_arm64.so" : "librust_pty.so";
+  }
+  const ptyLibPath = join4(packageRoot, "lib", ptyLibName);
+  const fulcrumDir = getFulcrumDir();
+  const debug = flags.debug === "true";
+  console.error(`Starting Fulcrum server${debug ? " (debug mode)" : ""}...`);
+  const serverProc = spawn("bun", [serverPath], {
+    detached: true,
+    stdio: "ignore",
+    env: {
+      ...process.env,
+      NODE_ENV: "production",
+      PORT: port.toString(),
+      HOST: host,
+      FULCRUM_DIR: fulcrumDir,
+      FULCRUM_PACKAGE_ROOT: packageRoot,
+      FULCRUM_VERSION: package_default.version,
+      BUN_PTY_LIB: ptyLibPath,
+      ...isClaudeInstalled() && { FULCRUM_CLAUDE_INSTALLED: "1" },
+      ...isOpencodeInstalled() && { FULCRUM_OPENCODE_INSTALLED: "1" },
+      ...debug && { LOG_LEVEL: "debug", DEBUG: "1" }
+    }
+  });
+  serverProc.unref();
+  const pid = serverProc.pid;
+  if (!pid) {
+    throw new CliError("START_FAILED", "Failed to start server process", ExitCodes.ERROR);
+  }
+  writePid(pid);
+  await new Promise((resolve) => setTimeout(resolve, 1000));
+  if (!isProcessRunning(pid)) {
+    throw new CliError("START_FAILED", "Server process died immediately after starting", ExitCodes.ERROR);
+  }
+  if (isJsonOutput()) {
+    output({
+      pid,
+      port,
+      url: `http://localhost:${port}`
+    });
+  } else {
+    const hasAgent = isClaudeInstalled() || isOpencodeInstalled();
+    showGettingStartedTips(port, hasAgent);
+  }
+}
+function showGettingStartedTips(port, hasAgent) {
+  console.error(`
+Fulcrum is running at http://localhost:${port}
 
-# When blocked or need input
-fulcrum notify "Need Input" "Which approach should I use for the database migration?"
-\`\`\`
+Getting Started:
+  1. Open http://localhost:${port} in your browser
+  2. Add a repository to get started
+  3. Create a task to spin up an isolated worktree
+  4. Run your AI agent in the task terminal
 
-## Global Options
+Commands:
+  fulcrum status    Check server status
+  fulcrum doctor    Check all dependencies
+  fulcrum down      Stop the server
+`);
+  if (!hasAgent) {
+    console.error(`Note: No AI agents detected. Install one to get started:
+  Claude Code: curl -fsSL https://claude.ai/install.sh | bash
+  OpenCode:    curl -fsSL https://opencode.ai/install | bash
+`);
+  }
+}
 
-These flags work with most commands:
+// cli/src/commands/down.ts
+init_errors();
+async function handleDownCommand() {
+  const pid = readPid();
+  if (!pid) {
+    throw new CliError("NOT_RUNNING", "No PID file found. Fulcrum server may not be running.", ExitCodes.ERROR);
+  }
+  if (!isProcessRunning(pid)) {
+    removePid();
+    if (isJsonOutput()) {
+      output({ stopped: true, pid, wasRunning: false });
+    } else {
+      console.log(`Fulcrum was not running (stale PID file cleaned up)`);
+    }
+    return;
+  }
+  try {
+    process.kill(pid, "SIGTERM");
+  } catch (err) {
+    throw new CliError("KILL_FAILED", `Failed to stop server (PID: ${pid}): ${err}`, ExitCodes.ERROR);
+  }
+  let attempts = 0;
+  while (attempts < 50 && isProcessRunning(pid)) {
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    attempts++;
+  }
+  if (isProcessRunning(pid)) {
+    try {
+      process.kill(pid, "SIGKILL");
+    } catch {}
+  }
+  removePid();
+  if (isJsonOutput()) {
+    output({ stopped: true, pid, wasRunning: true });
+  } else {
+    console.log(`Fulcrum stopped (PID: ${pid})`);
+  }
+}
 
-- \`--port=<port>\` - Server port (default: 7777)
-- \`--url=<url>\` - Override full server URL
-- \`--pretty\` - Pretty-print JSON output for human readability
+// cli/src/commands/migrate-from-vibora.ts
+init_server();
+async function handleMigrateFromViboraCommand(flags) {
+  const autoYes = flags.yes === "true" || flags.y === "true";
+  if (!needsViboraMigration()) {
+    if (isJsonOutput()) {
+      output({ migrated: false, reason: "no_migration_needed" });
+    } else {
+      console.error("No migration needed.");
+      console.error(`  ~/.vibora does not exist or ~/.fulcrum already has data.`);
+    }
+    return;
+  }
+  const viboraDir = getLegacyViboraDir();
+  const fulcrumDir = getFulcrumDir();
+  if (!isJsonOutput()) {
+    console.error(`
+Found existing Vibora data at ${viboraDir}`);
+    console.error("Fulcrum (formerly Vibora) now uses ~/.fulcrum for data storage.");
+    console.error("");
+    console.error("Your existing data can be copied to the new location.");
+    console.error("This is non-destructive - your ~/.vibora directory will be left untouched.");
+    console.error("");
+  }
+  const shouldMigrate = autoYes || await confirm("Would you like to copy your data to ~/.fulcrum?");
+  if (!shouldMigrate) {
+    if (isJsonOutput()) {
+      output({ migrated: false, reason: "user_declined" });
+    } else {
+      console.error("Migration skipped.");
+      console.error("You can run this command again later to migrate.");
+    }
+    return;
+  }
+  if (!isJsonOutput()) {
+    console.error("Copying data from ~/.vibora to ~/.fulcrum...");
+  }
+  const success2 = migrateFromVibora();
+  if (success2) {
+    if (isJsonOutput()) {
+      output({ migrated: true, from: viboraDir, to: fulcrumDir });
+    } else {
+      console.error("Migration complete!");
+      console.error(`  Data copied from ${viboraDir} to ${fulcrumDir}`);
+      console.error("  Your original ~/.vibora directory has been preserved.");
+    }
+  } else {
+    if (isJsonOutput()) {
+      output({ migrated: false, reason: "migration_failed" });
+    } else {
+      console.error("Migration failed.");
+      console.error("You can manually copy files from ~/.vibora to ~/.fulcrum");
+    }
+    process.exitCode = 1;
+  }
+}
 
-## Task Statuses
+// cli/src/commands/status.ts
+init_server();
+async function handleStatusCommand(flags) {
+  const pid = readPid();
+  const port = getPort(flags.port);
+  const serverUrl = discoverServerUrl(flags.url, flags.port);
+  const pidRunning = pid !== null && isProcessRunning(pid);
+  let healthOk = false;
+  let version3 = null;
+  let uptime = null;
+  if (pidRunning) {
+    try {
+      const res = await fetch(`${serverUrl}/health`, { signal: AbortSignal.timeout(2000) });
+      healthOk = res.ok;
+      if (res.ok) {
+        const health = await res.json();
+        version3 = health.version || null;
+        uptime = health.uptime || null;
+      }
+    } catch {}
+  }
+  const data = {
+    running: pidRunning,
+    healthy: healthOk,
+    pid: pid || null,
+    port,
+    url: serverUrl,
+    version: version3,
+    uptime
+  };
+  if (isJsonOutput()) {
+    output(data);
+  } else {
+    if (pidRunning) {
+      const healthStatus = healthOk ? "healthy" : "not responding";
+      console.log(`Fulcrum is running (${healthStatus})`);
+      console.log(`  PID:  ${pid}`);
+      console.log(`  URL:  ${serverUrl}`);
+      if (version3)
+        console.log(`  Version: ${version3}`);
+      if (uptime)
+        console.log(`  Uptime:  ${Math.floor(uptime / 1000)}s`);
+    } else {
+      console.log("Fulcrum is not running");
+      console.log(`
+Start with: fulcrum up`);
+    }
+  }
+}
 
-- \`IN_PROGRESS\` - Task is being worked on
-- \`IN_REVIEW\` - Task is complete and awaiting review
-- \`DONE\` - Task is finished
-- \`CANCELED\` - Task was abandoned
+// cli/src/commands/git.ts
+init_client();
+init_errors();
+async function handleGitCommand(action, flags) {
+  const client = new FulcrumClient(flags.url, flags.port);
+  switch (action) {
+    case "status": {
+      const path = flags.path || process.cwd();
+      const status = await client.getStatus(path);
+      if (isJsonOutput()) {
+        output(status);
+      } else {
+        console.log(`Branch: ${status.branch}`);
+        if (status.ahead)
+          console.log(`  Ahead: ${status.ahead}`);
+        if (status.behind)
+          console.log(`  Behind: ${status.behind}`);
+        if (status.staged?.length)
+          console.log(`  Staged: ${status.staged.length} files`);
+        if (status.modified?.length)
+          console.log(`  Modified: ${status.modified.length} files`);
+        if (status.untracked?.length)
+          console.log(`  Untracked: ${status.untracked.length} files`);
+        if (!status.staged?.length && !status.modified?.length && !status.untracked?.length) {
+          console.log("  Working tree clean");
+        }
+      }
+      break;
+    }
+    case "diff": {
+      const path = flags.path || process.cwd();
+      const diff = await client.getDiff(path, {
+        staged: flags.staged === "true",
+        ignoreWhitespace: flags["ignore-whitespace"] === "true",
+        includeUntracked: flags["include-untracked"] === "true"
+      });
+      if (isJsonOutput()) {
+        output(diff);
+      } else {
+        console.log(diff.diff || "No changes");
+      }
+      break;
+    }
+    case "branches": {
+      const repo = flags.repo;
+      if (!repo) {
+        throw new CliError("MISSING_REPO", "--repo is required", ExitCodes.INVALID_ARGS);
+      }
+      const branches = await client.getBranches(repo);
+      if (isJsonOutput()) {
+        output(branches);
+      } else {
+        for (const branch of branches) {
+          const current = branch.current ? "* " : "  ";
+          console.log(`${current}${branch.name}`);
+        }
+      }
+      break;
+    }
+    default:
+      throw new CliError("UNKNOWN_ACTION", `Unknown action: ${action}. Valid: status, diff, branches`, ExitCodes.INVALID_ARGS);
+  }
+}
 
-## MCP Tools
+// cli/src/commands/worktrees.ts
+init_client();
+init_errors();
+async function handleWorktreesCommand(action, flags) {
+  const client = new FulcrumClient(flags.url, flags.port);
+  switch (action) {
+    case "list": {
+      const worktrees = await client.listWorktrees();
+      if (isJsonOutput()) {
+        output(worktrees);
+      } else {
+        if (worktrees.length === 0) {
+          console.log("No worktrees found");
+        } else {
+          for (const wt of worktrees) {
+            console.log(`${wt.path}`);
+            console.log(`  Branch: ${wt.branch}`);
+            if (wt.taskId)
+              console.log(`  Task: ${wt.taskId}`);
+          }
+        }
+      }
+      break;
+    }
+    case "delete": {
+      const worktreePath = flags.path;
+      if (!worktreePath) {
+        throw new CliError("MISSING_PATH", "--path is required", ExitCodes.INVALID_ARGS);
+      }
+      const deleteLinkedTask = flags["delete-task"] === "true" || flags["delete-task"] === "";
+      const result = await client.deleteWorktree(worktreePath, flags.repo, deleteLinkedTask);
+      if (isJsonOutput()) {
+        output(result);
+      } else {
+        console.log(`Deleted worktree: ${worktreePath}`);
+      }
+      break;
+    }
+    default:
+      throw new CliError("UNKNOWN_ACTION", `Unknown action: ${action}. Valid: list, delete`, ExitCodes.INVALID_ARGS);
+  }
+}
 
-Fulcrum provides a comprehensive set of MCP tools for AI agents. Use \`search_tools\` to discover available tools.
+// cli/src/commands/config.ts
+init_client();
+init_errors();
+async function handleConfigCommand(action, positional, flags) {
+  const client = new FulcrumClient(flags.url, flags.port);
+  switch (action) {
+    case "list": {
+      const config3 = await client.getAllConfig();
+      if (isJsonOutput()) {
+        output(config3);
+      } else {
+        console.log("Configuration:");
+        for (const [key, value] of Object.entries(config3)) {
+          const displayValue = value === null ? "(not set)" : value;
+          console.log(`  ${key}: ${displayValue}`);
+        }
+      }
+      break;
+    }
+    case "get": {
+      const [key] = positional;
+      if (!key) {
+        throw new CliError("MISSING_KEY", "Config key is required", ExitCodes.INVALID_ARGS);
+      }
+      const config3 = await client.getConfig(key);
+      if (isJsonOutput()) {
+        output(config3);
+      } else {
+        const value = config3.value === null ? "(not set)" : config3.value;
+        console.log(`${key}: ${value}`);
+      }
+      break;
+    }
+    case "set": {
+      const [key, value] = positional;
+      if (!key) {
+        throw new CliError("MISSING_KEY", "Config key is required", ExitCodes.INVALID_ARGS);
+      }
+      if (value === undefined) {
+        throw new CliError("MISSING_VALUE", "Config value is required", ExitCodes.INVALID_ARGS);
+      }
+      const parsedValue = /^\d+$/.test(value) ? parseInt(value, 10) : value;
+      const config3 = await client.setConfig(key, parsedValue);
+      if (isJsonOutput()) {
+        output(config3);
+      } else {
+        console.log(`Set ${key} = ${config3.value}`);
+      }
+      break;
+    }
+    case "reset": {
+      const [key] = positional;
+      if (!key) {
+        throw new CliError("MISSING_KEY", "Config key is required", ExitCodes.INVALID_ARGS);
+      }
+      const config3 = await client.resetConfig(key);
+      if (isJsonOutput()) {
+        output(config3);
+      } else {
+        console.log(`Reset ${key} to default: ${config3.value}`);
+      }
+      break;
+    }
+    default:
+      throw new CliError("UNKNOWN_ACTION", `Unknown action: ${action}. Valid: list, get, set, reset`, ExitCodes.INVALID_ARGS);
+  }
+}
 
-### Tool Discovery
+// cli/src/commands/opencode.ts
+init_errors();
+import {
+  mkdirSync as mkdirSync4,
+  writeFileSync as writeFileSync4,
+  existsSync as existsSync5,
+  readFileSync as readFileSync5,
+  unlinkSync as unlinkSync2,
+  copyFileSync,
+  renameSync
+} from "fs";
+import { homedir as homedir3 } from "os";
+import { join as join5 } from "path";
 
-#### search_tools
+// plugins/fulcrum-opencode/index.ts
+var fulcrum_opencode_default = `import type { Plugin } from "@opencode-ai/plugin"
+import { appendFileSync } from "node:fs"
+import { spawn } from "node:child_process"
+import { tmpdir } from "node:os"
+import { join } from "node:path"
 
-Search for available tools by keyword or category:
+declare const process: { env: Record<string, string | undefined> }
 
-\`\`\`json
-{
-  "query": "deploy",      // Optional: Search term
-  "category": "apps"      // Optional: Filter by category
+const LOG_FILE = join(tmpdir(), "fulcrum-opencode.log")
+const NOISY_EVENTS = new Set([
+  "message.part.updated",
+  "file.watcher.updated",
+  "tui.toast.show",
+  "config.updated",
+])
+const log = (msg: string) => {
+  try {
+    appendFileSync(LOG_FILE, \`[\${new Date().toISOString()}] \${msg}\\n\`)
+  } catch {
+    // Silently ignore logging errors - logging is non-critical
+  }
 }
-\`\`\`
-
-**Categories:** core, tasks, projects, repositories, apps, filesystem, git, notifications, exec
-
-**Example Usage:**
-\`\`\`
-search_tools { query: "project create" }
-\u2192 Returns tools for creating projects
-
-search_tools { category: "filesystem" }
-\u2192 Returns all filesystem tools
-\`\`\`
 
-### Task Tools
+/**
+ * Execute fulcrum command using spawn with shell option for proper PATH resolution.
+ * Using spawn with explicit args array prevents shell injection while shell:true
+ * ensures PATH is properly resolved (for NVM, fnm, etc. managed node installations).
+ * Includes 10 second timeout protection to prevent hanging.
+ */
+async function runFulcrumCommand(args: string[]): Promise<{ exitCode: number; stdout: string; stderr: string }> {
+  return new Promise((resolve) => {
+    let stdout = ''
+    let stderr = ''
+    let resolved = false
+    let processExited = false
+    let killTimeoutId: ReturnType<typeof setTimeout> | null = null
 
-- \`list_tasks\` - List tasks with flexible filtering (search, labels, statuses, date range, overdue)
-- \`get_task\` - Get task details by ID
-- \`create_task\` - Create a new task with worktree
-- \`update_task\` - Update task metadata
-- \`delete_task\` - Delete a task
-- \`move_task\` - Move task to different status
-- \`add_task_link\` - Add URL link to task
-- \`remove_task_link\` - Remove link from task
-- \`list_task_links\` - List all task links
-- \`add_task_label\` - Add a label to a task (returns similar labels to catch typos)
-- \`remove_task_label\` - Remove a label from a task
-- \`set_task_due_date\` - Set or clear task due date
-- \`list_labels\` - List all unique labels in use with optional search
+    const child = spawn(FULCRUM_CMD, args, { shell: true })
 
-#### Task Search and Filtering
+    const cleanup = () => {
+      processExited = true
+      if (killTimeoutId) {
+        clearTimeout(killTimeoutId)
+        killTimeoutId = null
+      }
+    }
 
-The \`list_tasks\` tool supports powerful filtering for AI agents:
+    child.stdout?.on('data', (data) => {
+      stdout += data.toString()
+    })
 
-\`\`\`json
-{
-  "search": "ocai",                              // Text search across title, labels, project name
-  "labels": ["bug", "urgent"],                   // Filter by multiple labels (OR logic)
-  "statuses": ["TO_DO", "IN_PROGRESS"],          // Filter by multiple statuses (OR logic)
-  "dueDateStart": "2026-01-18",                  // Start of date range
-  "dueDateEnd": "2026-01-25",                    // End of date range
-  "overdue": true                                // Only show overdue tasks
-}
-\`\`\`
+    child.stderr?.on('data', (data) => {
+      stderr += data.toString()
+    })
 
-#### Label Discovery
+    child.on('close', (code) => {
+      cleanup()
+      if (!resolved) {
+        resolved = true
+        resolve({ exitCode: code || 0, stdout, stderr })
+      }
+    })
 
-Use \`list_labels\` to discover exact label names before filtering:
+    child.on('error', (err) => {
+      cleanup()
+      if (!resolved) {
+        resolved = true
+        resolve({ exitCode: 1, stdout, stderr: err.message || '' })
+      }
+    })
 
-\`\`\`json
-// Find labels matching "communication"
-{ "search": "communication" }
-// Returns: [{ "name": "communication required", "count": 5 }]
-\`\`\`
+    // Add timeout protection to prevent hanging
+    const timeoutId = setTimeout(() => {
+      if (!resolved) {
+        resolved = true
+        log(\`Command timeout: \${FULCRUM_CMD} \${args.join(' ')}\`)
+        child.kill('SIGTERM')
+        // Schedule SIGKILL if process doesn't exit after SIGTERM
+        killTimeoutId = setTimeout(() => {
+          if (!processExited) {
+            log(\`Process didn't exit after SIGTERM, sending SIGKILL\`)
+            child.kill('SIGKILL')
+          }
+        }, 2000)
+        resolve({ exitCode: -1, stdout, stderr: \`Command timed out after \${FULCRUM_COMMAND_TIMEOUT_MS}ms\` })
+      }
+    }, FULCRUM_COMMAND_TIMEOUT_MS)
 
-This helps handle typos and variations - search first, then use the exact label name.
+    // Clear timeout if command completes
+    child.on('exit', () => clearTimeout(timeoutId))
+  })
+}
 
-### Project Tools
+let mainSessionId: string | null = null
+const subagentSessions = new Set<string>()
+let pendingIdleTimer: ReturnType<typeof setTimeout> | null = null
+let activityVersion = 0
+let lastStatus: "in-progress" | "review" | "" = ""
 
-- \`list_projects\` - List all projects
-- \`get_project\` - Get project details
-- \`create_project\` - Create from path, URL, or existing repo
-- \`update_project\` - Update name, description, status
-- \`delete_project\` - Delete project and optionally directory/app
-- \`scan_projects\` - Scan directory for git repos
-- \`list_project_links\` - List all URL links attached to a project
-- \`add_project_link\` - Add a URL link to a project (auto-detects type)
-- \`remove_project_link\` - Remove a URL link from a project
+const FULCRUM_CMD = "fulcrum"
+const IDLE_CONFIRMATION_DELAY_MS = 1500
+const FULCRUM_COMMAND_TIMEOUT_MS = 10000
+const STATUS_CHANGE_DEBOUNCE_MS = 500
 
-### Repository Tools
+let deferredContextCheck: Promise<boolean> | null = null
+let isFulcrumContext: boolean | null = null
+let pendingStatusCommand: Promise<{ exitCode: number; stdout: string; stderr: string }> | null = null
 
-- \`list_repositories\` - List all repositories (supports orphans filter)
-- \`get_repository\` - Get repository details by ID
-- \`add_repository\` - Add repository from local path
-- \`update_repository\` - Update repository metadata (name, agent, startup script)
-- \`delete_repository\` - Delete orphaned repository (fails if linked to project)
-- \`link_repository_to_project\` - Link repo to project (errors if already linked elsewhere)
-- \`unlink_repository_from_project\` - Unlink repo from project
+export const FulcrumPlugin: Plugin = async ({ $, directory }) => {
+  log("Plugin initializing...")
 
-### App/Deployment Tools
+  if (process.env.FULCRUM_TASK_ID) {
+    isFulcrumContext = true
+    log("Fulcrum context detected via env var")
+  } else {
+    deferredContextCheck = Promise.all([
+      $\`\${FULCRUM_CMD} --version\`.quiet().nothrow().text(),
+      runFulcrumCommand(['current-task', '--path', directory]),
+    ])
+      .then(([versionResult, taskResult]) => {
+        if (!versionResult) {
+          log("Fulcrum CLI not found")
+          return false
+        }
+        const inContext = taskResult.exitCode === 0
+        log(inContext ? "Fulcrum context active" : "Not a Fulcrum context")
+        return inContext
+      })
+      .catch(() => {
+        log("Fulcrum check failed")
+        return false
+      })
+  }
 
-- \`list_apps\` - List all deployed apps
-- \`get_app\` - Get app details with services
-- \`create_app\` - Create app for deployment
-- \`deploy_app\` - Trigger deployment
-- \`stop_app\` - Stop running app
-- \`get_app_logs\` - Get container logs
-- \`get_app_status\` - Get container status
-- \`list_deployments\` - Get deployment history
-- \`delete_app\` - Delete app
+  log("Plugin hooks registered")
 
-### Filesystem Tools
+  const checkContext = async (): Promise<boolean> => {
+    if (isFulcrumContext !== null) return isFulcrumContext
+    if (deferredContextCheck) {
+      isFulcrumContext = await deferredContextCheck
+      deferredContextCheck = null
+      return isFulcrumContext
+    }
+    return false
+  }
 
-Remote filesystem tools for working with files on the Fulcrum server. Useful when the agent runs on a different machine than the server (e.g., via SSH tunneling to Claude Desktop).
+  const cancelPendingIdle = () => {
+    if (pendingIdleTimer) {
+      clearTimeout(pendingIdleTimer)
+      pendingIdleTimer = null
+      log("Cancelled pending idle transition")
+    }
+  }
 
-- \`list_directory\` - List directory contents
-- \`get_file_tree\` - Get recursive file tree
-- \`read_file\` - Read file contents (secured)
-- \`write_file\` - Write entire file content (secured)
-- \`edit_file\` - Edit file by replacing a unique string (secured)
-- \`file_stat\` - Get file/directory metadata
-- \`is_git_repo\` - Check if directory is git repo
+  const setStatus = (status: "in-progress" | "review") => {
+    if (status === lastStatus) return
 
-### Command Execution
+    cancelPendingIdle()
 
-When using Claude Desktop with Fulcrum's MCP server, you can execute commands on the remote Fulcrum server. This is useful when connecting to Fulcrum via SSH port forwarding.
+    if (pendingStatusCommand) {
+      log(\`Status change already in progress, will retry after \${STATUS_CHANGE_DEBOUNCE_MS}ms\`)
+      setTimeout(() => setStatus(status), STATUS_CHANGE_DEBOUNCE_MS)
+      return
+    }
 
-#### execute_command
+    lastStatus = status
 
-Execute shell commands with optional persistent session support:
+    ;(async () => {
+      try {
+        log(\`Setting status: \${status}\`)
+        pendingStatusCommand = runFulcrumCommand(['current-task', status, '--path', directory])
+        const res = await pendingStatusCommand
+        pendingStatusCommand = null
 
-\`\`\`json
-{
-  "command": "echo hello world",
-  "sessionId": "optional-session-id",
-  "cwd": "/path/to/start",
-  "timeout": 30000,
-  "name": "my-session"
-}
-\`\`\`
+        if (res.exitCode !== 0) {
+          log(\`Status update failed: exitCode=\${res.exitCode}, stderr=\${res.stderr}\`)
+        }
+      } catch (e) {
+        log(\`Status update error: \${e}\`)
+        pendingStatusCommand = null
+      }
+    })()
+  }
 
-**Parameters:**
-- \`command\` (required) \u2014 The shell command to execute
-- \`sessionId\` (optional) \u2014 Reuse a session to preserve env vars, cwd, and shell state
-- \`cwd\` (optional) \u2014 Initial working directory (only used when creating new session)
-- \`timeout\` (optional) \u2014 Timeout in milliseconds (default: 30000)
-- \`name\` (optional) \u2014 Session name for identification (only used when creating new session)
+  const scheduleIdleTransition = () => {
+    cancelPendingIdle()
+    const currentVersion = ++activityVersion
 
-**Response:**
-\`\`\`json
-{
-  "sessionId": "uuid",
-  "stdout": "hello world",
-  "stderr": "",
-  "exitCode": 0,
-  "timedOut": false
-}
-\`\`\`
+    pendingIdleTimer = setTimeout(() => {
+      if (activityVersion !== currentVersion) {
+        log(
+          \`Stale idle transition (version \${currentVersion} vs \${activityVersion})\`,
+        )
+        return
+      }
+      setStatus("review")
+    }, IDLE_CONFIRMATION_DELAY_MS)
 
-### Session Workflow Example
+    log(
+      \`Scheduled idle transition (version \${currentVersion}, delay \${IDLE_CONFIRMATION_DELAY_MS}ms)\`,
+    )
+  }
 
-\`\`\`
-1. First command (creates named session):
-   execute_command { command: "cd /project && export API_KEY=secret", name: "dev-session" }
-   \u2192 Returns sessionId: "abc-123"
+  const recordActivity = (reason: string) => {
+    activityVersion++
+    cancelPendingIdle()
+    log(\`Activity: \${reason} (version now \${activityVersion})\`)
+  }
 
-2. Subsequent commands (reuse session):
-   execute_command { command: "echo $API_KEY", sessionId: "abc-123" }
-   \u2192 Returns stdout: "secret" (env var preserved)
+  return {
+    "chat.message": async (_input, output) => {
+      if (!(await checkContext())) return
 
-   execute_command { command: "pwd", sessionId: "abc-123" }
-   \u2192 Returns stdout: "/project" (cwd preserved)
+      if (output.message.role === "user") {
+        recordActivity("user message")
+        setStatus("in-progress")
+      } else if (output.message.role === "assistant") {
+        recordActivity("assistant message")
+      }
+    },
 
-3. Rename session if needed:
-   update_exec_session { sessionId: "abc-123", name: "new-name" }
+    event: async ({ event }) => {
+      if (!NOISY_EVENTS.has(event.type)) {
+        log(\`Event: \${event.type}\`)
+      }
 
-4. Cleanup when done:
-   destroy_exec_session { sessionId: "abc-123" }
-\`\`\`
+      if (!(await checkContext())) return
 
-Sessions persist until manually destroyed.
+      const props = (event.properties as Record<string, unknown>) || {}
 
-### list_exec_sessions
+      if (event.type === "session.created") {
+        const info = (props.info as Record<string, unknown>) || {}
+        const sessionId = info.id as string | undefined
+        const parentId = info.parentID as string | undefined
 
-List all active sessions with their name, current working directory, and timestamps.
+        if (parentId) {
+          if (sessionId) subagentSessions.add(sessionId)
+          log(\`Subagent session tracked: \${sessionId} (parent: \${parentId})\`)
+        } else if (!mainSessionId && sessionId) {
+          mainSessionId = sessionId
+          log(\`Main session set: \${mainSessionId}\`)
+        }
 
-### update_exec_session
+        recordActivity("session.created")
+        setStatus("in-progress")
+        return
+      }
 
-Rename an existing session for identification.
+      const status = props.status as Record<string, unknown> | undefined
+      if (
+        (event.type === "session.status" && status?.type === "busy") ||
+        event.type.startsWith("tool.execute")
+      ) {
+        recordActivity(event.type)
+        return
+      }
 
-### destroy_exec_session
+      if (
+        event.type === "session.idle" ||
+        (event.type === "session.status" && status?.type === "idle")
+      ) {
+        const info = (props.info as Record<string, unknown>) || {}
+        const sessionId =
+          (props.sessionID as string) || (info.id as string) || null
 
-Clean up a session when you're done to free resources.
+        if (sessionId && subagentSessions.has(sessionId)) {
+          log(\`Ignoring subagent idle: \${sessionId}\`)
+          return
+        }
 
-## Best Practices
+        if (mainSessionId && sessionId && sessionId !== mainSessionId) {
+          log(\`Ignoring non-main idle: \${sessionId} (main: \${mainSessionId})\`)
+          return
+        }
 
-1. **Use \`current-task\` inside worktrees** - It auto-detects which task you're in
-2. **Link PRs immediately** - Run \`fulcrum current-task pr <url>\` right after creating a PR
-3. **Link relevant resources** - Attach design docs, specs, or reference materials with \`fulcrum current-task link <url>\`
-4. **Mark review when done** - \`fulcrum current-task review\` notifies the user
-5. **Send notifications for blocking issues** - Keep the user informed of progress
-6. **Name sessions for identification** - Use descriptive names to find sessions later
-7. **Reuse sessions for related commands** - Preserve state across multiple execute_command calls
-8. **Clean up sessions when done** - Use destroy_exec_session to free resources
+        log(\`Main session idle detected: \${sessionId}\`)
+        scheduleIdleTransition()
+      }
+    },
+  }
+}
 `;
 
-// cli/src/commands/claude.ts
-var PLUGIN_DIR2 = join5(homedir3(), ".claude", "plugins", "fulcrum");
-var PLUGIN_FILES = [
-  { path: ".claude-plugin/plugin.json", content: plugin_default },
-  { path: "hooks/hooks.json", content: hooks_default },
-  { path: "mcp.json", content: mcp_default },
-  { path: "commands/pr.md", content: pr_default },
-  { path: "commands/task-info.md", content: task_info_default },
-  { path: "commands/notify.md", content: notify_default },
-  { path: "commands/linear.md", content: linear_default },
-  { path: "commands/review.md", content: review_default },
-  { path: "skills/vibora/SKILL.md", content: SKILL_default }
-];
-async function handleClaudeCommand(action) {
+// cli/src/commands/opencode.ts
+var OPENCODE_DIR = join5(homedir3(), ".opencode");
+var OPENCODE_CONFIG_PATH = join5(OPENCODE_DIR, "opencode.json");
+var PLUGIN_DIR = join5(homedir3(), ".config", "opencode", "plugin");
+var PLUGIN_PATH = join5(PLUGIN_DIR, "fulcrum.ts");
+var FULCRUM_MCP_CONFIG = {
+  type: "local",
+  command: ["fulcrum", "mcp"],
+  enabled: true
+};
+async function handleOpenCodeCommand(action) {
   if (action === "install") {
-    await installClaudePlugin();
+    await installOpenCodeIntegration();
     return;
   }
   if (action === "uninstall") {
-    await uninstallClaudePlugin();
+    await uninstallOpenCodeIntegration();
     return;
   }
-  throw new CliError("INVALID_ACTION", "Unknown action. Usage: fulcrum claude install | fulcrum claude uninstall", ExitCodes.INVALID_ARGS);
+  throw new CliError("INVALID_ACTION", "Unknown action. Usage: fulcrum opencode install | fulcrum opencode uninstall", ExitCodes.INVALID_ARGS);
 }
-async function installClaudePlugin() {
+async function installOpenCodeIntegration() {
   try {
-    console.log("Installing Claude Code plugin...");
-    if (existsSync5(PLUGIN_DIR2)) {
-      console.log("\u2022 Removing existing plugin installation...");
-      rmSync(PLUGIN_DIR2, { recursive: true });
-    }
-    for (const file2 of PLUGIN_FILES) {
-      const fullPath = join5(PLUGIN_DIR2, file2.path);
-      const dir = fullPath.substring(0, fullPath.lastIndexOf("/"));
-      mkdirSync4(dir, { recursive: true });
-      writeFileSync4(fullPath, file2.content, "utf-8");
-    }
-    console.log("\u2713 Installed plugin at " + PLUGIN_DIR2);
+    console.log("Installing OpenCode plugin...");
+    mkdirSync4(PLUGIN_DIR, { recursive: true });
+    writeFileSync4(PLUGIN_PATH, fulcrum_opencode_default, "utf-8");
+    console.log("\u2713 Installed plugin at " + PLUGIN_PATH);
+    console.log("Configuring MCP server...");
+    const mcpConfigured = addMcpServer();
     console.log("");
-    console.log("Installation complete! Restart Claude Code to apply changes.");
+    if (mcpConfigured) {
+      console.log("Installation complete! Restart OpenCode to apply changes.");
+    } else {
+      console.log("Plugin installed, but MCP configuration was skipped.");
+      console.log("Please add the MCP server manually (see above).");
+    }
   } catch (err) {
-    throw new CliError("INSTALL_FAILED", `Failed to install Claude plugin: ${err instanceof Error ? err.message : String(err)}`, ExitCodes.ERROR);
+    throw new CliError("INSTALL_FAILED", `Failed to install OpenCode integration: ${err instanceof Error ? err.message : String(err)}`, ExitCodes.ERROR);
   }
 }
-async function uninstallClaudePlugin() {
+async function uninstallOpenCodeIntegration() {
   try {
-    if (existsSync5(PLUGIN_DIR2)) {
-      rmSync(PLUGIN_DIR2, { recursive: true });
-      console.log("\u2713 Removed plugin from " + PLUGIN_DIR2);
-      console.log("");
-      console.log("Uninstall complete! Restart Claude Code to apply changes.");
+    let removedPlugin = false;
+    let removedMcp = false;
+    if (existsSync5(PLUGIN_PATH)) {
+      unlinkSync2(PLUGIN_PATH);
+      console.log("\u2713 Removed plugin from " + PLUGIN_PATH);
+      removedPlugin = true;
+    } else {
+      console.log("\u2022 Plugin not found (already removed)");
+    }
+    removedMcp = removeMcpServer();
+    if (!removedPlugin && !removedMcp) {
+      console.log("Nothing to uninstall.");
     } else {
-      console.log("Nothing to uninstall. Plugin not found at " + PLUGIN_DIR2);
+      console.log("");
+      console.log("Uninstall complete! Restart OpenCode to apply changes.");
     }
   } catch (err) {
-    throw new CliError("UNINSTALL_FAILED", `Failed to uninstall Claude plugin: ${err instanceof Error ? err.message : String(err)}`, ExitCodes.ERROR);
+    throw new CliError("UNINSTALL_FAILED", `Failed to uninstall OpenCode integration: ${err instanceof Error ? err.message : String(err)}`, ExitCodes.ERROR);
+  }
+}
+function getMcpObject(config3) {
+  const mcp = config3.mcp;
+  if (mcp && typeof mcp === "object" && !Array.isArray(mcp)) {
+    return mcp;
+  }
+  return {};
+}
+function addMcpServer() {
+  mkdirSync4(OPENCODE_DIR, { recursive: true });
+  let config3 = {};
+  if (existsSync5(OPENCODE_CONFIG_PATH)) {
+    try {
+      const content = readFileSync5(OPENCODE_CONFIG_PATH, "utf-8");
+      config3 = JSON.parse(content);
+    } catch {
+      console.log("\u26A0 Could not parse existing opencode.json, skipping MCP configuration");
+      console.log("  Add manually to ~/.opencode/opencode.json:");
+      console.log('    "mcp": { "fulcrum": { "type": "local", "command": ["fulcrum", "mcp"], "enabled": true } }');
+      return false;
+    }
+  }
+  const mcp = getMcpObject(config3);
+  if (mcp.fulcrum) {
+    console.log("\u2022 MCP server already configured, preserving existing configuration");
+    return true;
+  }
+  if (existsSync5(OPENCODE_CONFIG_PATH)) {
+    copyFileSync(OPENCODE_CONFIG_PATH, OPENCODE_CONFIG_PATH + ".backup");
+  }
+  config3.mcp = {
+    ...mcp,
+    fulcrum: FULCRUM_MCP_CONFIG
+  };
+  const tempPath = OPENCODE_CONFIG_PATH + ".tmp";
+  try {
+    writeFileSync4(tempPath, JSON.stringify(config3, null, 2), "utf-8");
+    renameSync(tempPath, OPENCODE_CONFIG_PATH);
+  } catch (error46) {
+    try {
+      if (existsSync5(tempPath)) {
+        unlinkSync2(tempPath);
+      }
+    } catch {}
+    throw error46;
+  }
+  console.log("\u2713 Added MCP server to " + OPENCODE_CONFIG_PATH);
+  return true;
+}
+function removeMcpServer() {
+  if (!existsSync5(OPENCODE_CONFIG_PATH)) {
+    console.log("\u2022 MCP config not found (already removed)");
+    return false;
+  }
+  let config3;
+  try {
+    const content = readFileSync5(OPENCODE_CONFIG_PATH, "utf-8");
+    config3 = JSON.parse(content);
+  } catch {
+    console.log("\u26A0 Could not parse opencode.json, skipping MCP removal");
+    return false;
+  }
+  const mcp = getMcpObject(config3);
+  if (!mcp.fulcrum) {
+    console.log("\u2022 MCP server not configured (already removed)");
+    return false;
+  }
+  copyFileSync(OPENCODE_CONFIG_PATH, OPENCODE_CONFIG_PATH + ".backup");
+  delete mcp.fulcrum;
+  if (Object.keys(mcp).length === 0) {
+    delete config3.mcp;
+  } else {
+    config3.mcp = mcp;
+  }
+  const tempPath = OPENCODE_CONFIG_PATH + ".tmp";
+  try {
+    writeFileSync4(tempPath, JSON.stringify(config3, null, 2), "utf-8");
+    renameSync(tempPath, OPENCODE_CONFIG_PATH);
+  } catch (error46) {
+    try {
+      if (existsSync5(tempPath)) {
+        unlinkSync2(tempPath);
+      }
+    } catch {}
+    throw error46;
   }
+  console.log("\u2713 Removed MCP server from " + OPENCODE_CONFIG_PATH);
+  return true;
 }
 
 // cli/src/commands/notifications.ts
@@ -50245,6 +50589,127 @@ var tasksListDependenciesCommand = defineCommand({
     await handleTasksCommand("list-dependencies", [args.id], toFlags(args));
   }
 });
+var tasksLabelsCommand = defineCommand({
+  meta: {
+    name: "labels",
+    description: "List all labels in use across tasks"
+  },
+  args: {
+    ...globalArgs,
+    search: {
+      type: "string",
+      description: "Filter labels by substring match"
+    }
+  },
+  async run({ args }) {
+    if (args.json)
+      setJsonOutput(true);
+    await handleTasksCommand("labels", [], toFlags(args));
+  }
+});
+var tasksAttachmentsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List attachments for a task"
+  },
+  args: {
+    ...globalArgs,
+    id: {
+      type: "positional",
+      description: "Task ID",
+      required: true
+    }
+  },
+  async run({ args }) {
+    if (args.json)
+      setJsonOutput(true);
+    await handleTasksCommand("attachments", ["list", args.id], toFlags(args));
+  }
+});
+var tasksAttachmentsUploadCommand = defineCommand({
+  meta: {
+    name: "upload",
+    description: "Upload a file to a task"
+  },
+  args: {
+    ...globalArgs,
+    id: {
+      type: "positional",
+      description: "Task ID",
+      required: true
+    },
+    file: {
+      type: "positional",
+      description: "File path to upload",
+      required: true
+    }
+  },
+  async run({ args }) {
+    if (args.json)
+      setJsonOutput(true);
+    await handleTasksCommand("attachments", ["upload", args.id, args.file], toFlags(args));
+  }
+});
+var tasksAttachmentsDeleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: "Delete an attachment from a task"
+  },
+  args: {
+    ...globalArgs,
+    id: {
+      type: "positional",
+      description: "Task ID",
+      required: true
+    },
+    "attachment-id": {
+      type: "positional",
+      description: "Attachment ID",
+      required: true
+    }
+  },
+  async run({ args }) {
+    if (args.json)
+      setJsonOutput(true);
+    await handleTasksCommand("attachments", ["delete", args.id, args["attachment-id"]], toFlags(args));
+  }
+});
+var tasksAttachmentsPathCommand = defineCommand({
+  meta: {
+    name: "path",
+    description: "Get local file path for an attachment"
+  },
+  args: {
+    ...globalArgs,
+    id: {
+      type: "positional",
+      description: "Task ID",
+      required: true
+    },
+    "attachment-id": {
+      type: "positional",
+      description: "Attachment ID",
+      required: true
+    }
+  },
+  async run({ args }) {
+    if (args.json)
+      setJsonOutput(true);
+    await handleTasksCommand("attachments", ["path", args.id, args["attachment-id"]], toFlags(args));
+  }
+});
+var tasksAttachmentsCommand = defineCommand({
+  meta: {
+    name: "attachments",
+    description: "Manage task attachments"
+  },
+  subCommands: {
+    list: tasksAttachmentsListCommand,
+    upload: tasksAttachmentsUploadCommand,
+    delete: tasksAttachmentsDeleteCommand,
+    path: tasksAttachmentsPathCommand
+  }
+});
 var tasksCommand = defineCommand({
   meta: {
     name: "tasks",
@@ -50262,7 +50727,9 @@ var tasksCommand = defineCommand({
     "set-due-date": tasksSetDueDateCommand,
     "add-dependency": tasksAddDependencyCommand,
     "remove-dependency": tasksRemoveDependencyCommand,
-    "list-dependencies": tasksListDependenciesCommand
+    "list-dependencies": tasksListDependenciesCommand,
+    labels: tasksLabelsCommand,
+    attachments: tasksAttachmentsCommand
   }
 });
 var projectsListCommand = defineCommand({