@knowsuchagency/fulcrum 1.2.3 → 1.4.0

package/bin/fulcrum.js

@@ -47617,8 +47617,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 dirname2, join as join4 } from "path";
 import { fileURLToPath } from "url";
 init_errors();
 
@@ -47899,1367 +47899,335 @@ function installUv() {
     return false;
   return installDependency(dep);
 }
-// package.json
-var package_default = {
-  name: "@knowsuchagency/fulcrum",
-  private: true,
-  version: "1.2.3",
-  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;
-    }
-    dir = dirname2(dir);
-  }
-  return dirname2(dirname2(dirname2(currentFile)));
+// cli/src/commands/claude.ts
+init_errors();
+import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync3, existsSync as existsSync3, rmSync, readFileSync as readFileSync4 } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join3 } from "path";
+
+// plugins/fulcrum/.claude-plugin/plugin.json
+var plugin_default = `{
+  "name": "fulcrum",
+  "description": "Fulcrum task orchestration for Claude Code",
+  "version": "1.4.0",
+  "author": {
+    "name": "Fulcrum"
+  },
+  "hooks": "./hooks/hooks.json",
+  "mcpServers": "./.mcp.json",
+  "skills": "./skills/",
+  "commands": "./commands/"
 }
-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);
+`;
+
+// plugins/fulcrum/hooks/hooks.json
+var hooks_default = `{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "fulcrum current-task review 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);
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "fulcrum current-task in-progress 2>/dev/null || true"
+          }
+        ]
       }
-      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);
+}
+`;
+
+// plugins/fulcrum/.mcp.json
+var _mcp_default = `{
+  "mcpServers": {
+    "fulcrum": {
+      "command": "fulcrum",
+      "args": ["mcp"]
     }
   }
-  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
+// plugins/fulcrum/commands/pr.md
+var pr_default = `---
+description: Link a GitHub PR to the current fulcrum task
+---
+Link the PR to this task: \`fulcrum current-task pr $ARGUMENTS\`
 
-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
-`);
-  }
-}
+This enables auto-completion when the PR is merged.
+`;
 
-// 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})`);
-  }
-}
+// plugins/fulcrum/commands/task-info.md
+var task_info_default = `---
+description: Show current fulcrum task info
+---
+Show current task details: \`fulcrum current-task\`
+`;
 
-// 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;
-  }
-}
+// plugins/fulcrum/commands/notify.md
+var notify_default = `---
+description: Send a notification to the user
+---
+Send a notification: \`fulcrum notify $ARGUMENTS\`
 
-// 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`);
-    }
-  }
-}
+Format: fulcrum notify "Title" "Message body"
+`;
 
-// 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);
-  }
-}
+// 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\`
+`;
 
-// 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);
-  }
-}
+// 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\`
 
-// 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);
-  }
-}
+This sends a notification to the user.
+`;
 
-// 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/skills/vibora/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.
+---
 
-// 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"
+# Fulcrum - AI Agent Orchestration
 
-declare const process: { env: Record<string, string | undefined> }
+## Overview
 
-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
-  }
-}
+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.
 
-/**
- * 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
+**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
 
-    const child = spawn(FULCRUM_CMD, args, { shell: true })
+## When to Use This Skill
 
-    const cleanup = () => {
-      processExited = true
-      if (killTimeoutId) {
-        clearTimeout(killTimeoutId)
-        killTimeoutId = null
-      }
-    }
+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
 
-    child.stdout?.on('data', (data) => {
-      stdout += data.toString()
-    })
+Use the Fulcrum MCP tools when:
+- **Executing commands remotely** - Run shell commands on the Fulcrum server from Claude Desktop
+- **Stateful workflows** - Use persistent sessions to maintain environment variables and working directory across commands
 
-    child.stderr?.on('data', (data) => {
-      stderr += data.toString()
-    })
+## Core CLI Commands
 
-    child.on('close', (code) => {
-      cleanup()
-      if (!resolved) {
-        resolved = true
-        resolve({ exitCode: code || 0, stdout, stderr })
-      }
-    })
+### current-task (Primary Agent Workflow)
 
-    child.on('error', (err) => {
-      cleanup()
-      if (!resolved) {
-        resolved = true
-        resolve({ exitCode: 1, stdout, stderr: err.message || '' })
-      }
-    })
+When running inside a Fulcrum task worktree, use these commands to manage the current task:
 
-    // 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)
+\`\`\`bash
+# Get current task info (JSON output)
+fulcrum current-task
 
-    // Clear timeout if command completes
-    child.on('exit', () => clearTimeout(timeoutId))
-  })
-}
+# Update task status
+fulcrum current-task in-progress   # Mark as IN_PROGRESS
+fulcrum current-task review        # Mark as IN_REVIEW (notifies user)
+fulcrum current-task done          # Mark as DONE
+fulcrum current-task cancel        # Mark as CANCELED
 
-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" | "" = ""
+# Link a GitHub PR to the current task
+fulcrum current-task pr <github-pr-url>
 
-const FULCRUM_CMD = "fulcrum"
-const IDLE_CONFIRMATION_DELAY_MS = 1500
-const FULCRUM_COMMAND_TIMEOUT_MS = 10000
-const STATUS_CHANGE_DEBOUNCE_MS = 500
+# Link a Linear ticket to the current task
+fulcrum current-task linear <linear-issue-url>
 
-let deferredContextCheck: Promise<boolean> | null = null
-let isFulcrumContext: boolean | null = null
-let pendingStatusCommand: Promise<{ exitCode: number; stdout: string; stderr: string }> | null = null
+# Add arbitrary URL links to the task
+fulcrum current-task link <url>                  # Add link (auto-detects type/label)
+fulcrum current-task link <url> --label "Docs"   # Add link with custom label
+fulcrum current-task link                        # List all links
+fulcrum current-task link --remove <url-or-id>   # Remove a link
+\`\`\`
 
-export const FulcrumPlugin: Plugin = async ({ $, directory }) => {
-  log("Plugin initializing...")
+### tasks
 
-  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
-      })
-  }
+Manage tasks across the system:
 
-  log("Plugin hooks registered")
+\`\`\`bash
+# List all tasks
+fulcrum tasks list
+fulcrum tasks list --status=IN_PROGRESS   # Filter by status
+fulcrum tasks list --search="ocai"        # Search by title, labels
+fulcrum tasks list --label="bug"          # Filter by label
 
-  const checkContext = async (): Promise<boolean> => {
-    if (isFulcrumContext !== null) return isFulcrumContext
-    if (deferredContextCheck) {
-      isFulcrumContext = await deferredContextCheck
-      deferredContextCheck = null
-      return isFulcrumContext
-    }
-    return false
-  }
+# List all labels in use
+fulcrum tasks labels                      # Show all labels with counts
+fulcrum tasks labels --search="comm"      # Find labels matching substring
 
-  const cancelPendingIdle = () => {
-    if (pendingIdleTimer) {
-      clearTimeout(pendingIdleTimer)
-      pendingIdleTimer = null
-      log("Cancelled pending idle transition")
-    }
-  }
+# Get a specific task
+fulcrum tasks get <task-id>
 
-  const setStatus = (status: "in-progress" | "review") => {
-    if (status === lastStatus) return
+# Create a new task
+fulcrum tasks create --title="My Task" --repo=/path/to/repo
 
-    cancelPendingIdle()
+# Update task metadata
+fulcrum tasks update <task-id> --title="New Title"
 
-    if (pendingStatusCommand) {
-      log(\`Status change already in progress, will retry after \${STATUS_CHANGE_DEBOUNCE_MS}ms\`)
-      setTimeout(() => setStatus(status), STATUS_CHANGE_DEBOUNCE_MS)
-      return
-    }
+# Move task to different status
+fulcrum tasks move <task-id> --status=IN_REVIEW
 
-    lastStatus = status
+# Delete a task
+fulcrum tasks delete <task-id>
+fulcrum tasks delete <task-id> --delete-worktree   # Also delete worktree
+\`\`\`
 
-    ;(async () => {
-      try {
-        log(\`Setting status: \${status}\`)
-        pendingStatusCommand = runFulcrumCommand(['current-task', status, '--path', directory])
-        const res = await pendingStatusCommand
-        pendingStatusCommand = null
+### notifications
 
-        if (res.exitCode !== 0) {
-          log(\`Status update failed: exitCode=\${res.exitCode}, stderr=\${res.stderr}\`)
-        }
-      } catch (e) {
-        log(\`Status update error: \${e}\`)
-        pendingStatusCommand = null
-      }
-    })()
-  }
+Send notifications to the user:
 
-  const scheduleIdleTransition = () => {
-    cancelPendingIdle()
-    const currentVersion = ++activityVersion
+\`\`\`bash
+# Send a notification
+fulcrum notify "Title" "Message body"
 
-    pendingIdleTimer = setTimeout(() => {
-      if (activityVersion !== currentVersion) {
-        log(
-          \`Stale idle transition (version \${currentVersion} vs \${activityVersion})\`,
-        )
-        return
-      }
-      setStatus("review")
-    }, IDLE_CONFIRMATION_DELAY_MS)
+# Check notification settings
+fulcrum notifications
 
-    log(
-      \`Scheduled idle transition (version \${currentVersion}, delay \${IDLE_CONFIRMATION_DELAY_MS}ms)\`,
-    )
-  }
+# Enable/disable notifications
+fulcrum notifications enable
+fulcrum notifications disable
 
-  const recordActivity = (reason: string) => {
-    activityVersion++
-    cancelPendingIdle()
-    log(\`Activity: \${reason} (version now \${activityVersion})\`)
-  }
+# Test a notification channel
+fulcrum notifications test sound
+fulcrum notifications test slack
+fulcrum notifications test discord
+fulcrum notifications test pushover
 
-  return {
-    "chat.message": async (_input, output) => {
-      if (!(await checkContext())) return
+# Configure a channel
+fulcrum notifications set slack webhookUrl <url>
+\`\`\`
 
-      if (output.message.role === "user") {
-        recordActivity("user message")
-        setStatus("in-progress")
-      } else if (output.message.role === "assistant") {
-        recordActivity("assistant message")
-      }
-    },
+### Server Management
 
-    event: async ({ event }) => {
-      if (!NOISY_EVENTS.has(event.type)) {
-        log(\`Event: \${event.type}\`)
-      }
+\`\`\`bash
+fulcrum up          # Start Fulcrum server daemon
+fulcrum down        # Stop Fulcrum server
+fulcrum status      # Check if server is running
+fulcrum health      # Check server health
+\`\`\`
 
-      if (!(await checkContext())) return
+### Git Operations
 
-      const props = (event.properties as Record<string, unknown>) || {}
+\`\`\`bash
+fulcrum git status              # Git status for current worktree
+fulcrum git diff                # Git diff for current worktree
+fulcrum worktrees list          # List all worktrees
+\`\`\`
 
-      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
+### projects
 
-        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}\`)
-        }
+Manage projects (repositories with metadata):
 
-        recordActivity("session.created")
-        setStatus("in-progress")
-        return
-      }
+\`\`\`bash
+# List all projects
+fulcrum projects list
+fulcrum projects list --status=active    # Filter by status (active, archived)
 
-      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
-      }
+# Get project details
+fulcrum projects get <project-id>
 
-      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
+# Create a new project
+fulcrum projects create --name="My Project" --path=/path/to/repo          # From local path
+fulcrum projects create --name="My Project" --url=https://github.com/...  # Clone from URL
+fulcrum projects create --name="My Project" --repository-id=<repo-id>     # Link existing repo
 
-        if (sessionId && subagentSessions.has(sessionId)) {
-          log(\`Ignoring subagent idle: \${sessionId}\`)
-          return
-        }
+# Update project
+fulcrum projects update <project-id> --name="New Name"
+fulcrum projects update <project-id> --status=archived
 
-        if (mainSessionId && sessionId && sessionId !== mainSessionId) {
-          log(\`Ignoring non-main idle: \${sessionId} (main: \${mainSessionId})\`)
-          return
-        }
+# Delete project
+fulcrum projects delete <project-id>
+fulcrum projects delete <project-id> --delete-directory   # Also delete directory
+fulcrum projects delete <project-id> --delete-app         # Also delete linked app
 
-        log(\`Main session idle detected: \${sessionId}\`)
-        scheduleIdleTransition()
-      }
-    },
-  }
-}
-`;
+# Scan for git repositories
+fulcrum projects scan                        # Scan default directory
+fulcrum projects scan --directory=/path      # Scan specific directory
 
-// 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;
-}
+# Manage project links (URLs)
+fulcrum projects links list <project-id>
+fulcrum projects links add <project-id> <url> --label="Custom Label"
+fulcrum projects links remove <project-id> <link-id>
+\`\`\`
 
-// 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";
+### repositories
 
-// plugins/fulcrum/.claude-plugin/plugin.json
-var plugin_default = `{
-  "name": "fulcrum",
-  "description": "Fulcrum task orchestration for Claude Code",
-  "version": "1.2.3",
-  "author": {
-    "name": "Fulcrum"
-  },
-  "hooks": "./hooks/hooks.json"
-}
-`;
+Manage repositories (code sources that can be linked to projects):
 
-// 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"
-          }
-        ]
-      }
-    ]
-  }
-}
-`;
+\`\`\`bash
+# List repositories
+fulcrum repositories list
+fulcrum repositories list --orphans          # Unlinked repos only
+fulcrum repositories list --project-id=<id>  # Filter by project
 
-// plugins/fulcrum/mcp.json
-var mcp_default = `{
-  "mcpServers": {
-    "fulcrum": {
-      "command": "fulcrum",
-      "args": ["mcp"]
-    }
-  }
-}
-`;
+# Get repository details
+fulcrum repositories get <repo-id>
 
-// plugins/fulcrum/commands/pr.md
-var pr_default = `---
-description: Link a GitHub PR to the current fulcrum task
----
-Link the PR to this task: \`fulcrum current-task pr $ARGUMENTS\`
+# Add a new repository from local path
+fulcrum repositories add --path=/path/to/repo
+fulcrum repositories add --path=/path/to/repo --display-name="My Repo"
 
-This enables auto-completion when the PR is merged.
-`;
+# Update repository
+fulcrum repositories update <repo-id> --display-name="New Name"
+fulcrum repositories update <repo-id> --default-agent=claude
+fulcrum repositories update <repo-id> --startup-script="mise run dev"
+fulcrum repositories update <repo-id> --copy-files=".env,.env.local"
 
-// plugins/fulcrum/commands/task-info.md
-var task_info_default = `---
-description: Show current fulcrum task info
----
-Show current task details: \`fulcrum current-task\`
-`;
+# Delete orphaned repository (fails if linked to a project)
+fulcrum repositories delete <repo-id>
 
-// plugins/fulcrum/commands/notify.md
-var notify_default = `---
-description: Send a notification to the user
----
-Send a notification: \`fulcrum notify $ARGUMENTS\`
+# Link repository to project (repos can only be linked to one project)
+fulcrum repositories link <repo-id> <project-id>
+fulcrum repositories link <repo-id> <project-id> --as-primary
+fulcrum repositories link <repo-id> <project-id> --force  # Move from existing project
 
-Format: fulcrum notify "Title" "Message body"
-`;
+# Unlink repository from project
+fulcrum repositories unlink <repo-id> <project-id>
+\`\`\`
 
-// 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\`
-`;
+### apps
 
-// 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\`
+Manage Docker Compose app deployments:
 
-This sends a notification to the user.
-`;
+\`\`\`bash
+# List all apps
+fulcrum apps list
+fulcrum apps list --status=running   # Filter by status (stopped, building, running, failed)
 
-// plugins/fulcrum/skills/vibora/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.
----
+# Get app details
+fulcrum apps get <app-id>
 
-# Fulcrum - AI Agent Orchestration
+# Create a new app
+fulcrum apps create --name="My App" --repository-id=<repo-id>
+fulcrum apps create --name="My App" --repository-id=<repo-id> --branch=develop --auto-deploy
 
-## Overview
+# Update app
+fulcrum apps update <app-id> --name="New Name"
+fulcrum apps update <app-id> --auto-deploy      # Enable auto-deploy
+fulcrum apps update <app-id> --no-cache         # Enable no-cache builds
 
-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.
-
-**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
-
-## When to Use This Skill
-
-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
-
-Use the Fulcrum MCP tools when:
-- **Executing commands remotely** - Run shell commands on the Fulcrum server from Claude Desktop
-- **Stateful workflows** - Use persistent sessions to maintain environment variables and working directory across commands
-
-## Core CLI Commands
-
-### current-task (Primary Agent Workflow)
-
-When running inside a Fulcrum task worktree, use these commands to manage the current task:
-
-\`\`\`bash
-# Get current task info (JSON output)
-fulcrum current-task
-
-# Update task status
-fulcrum current-task in-progress   # Mark as IN_PROGRESS
-fulcrum current-task review        # Mark as IN_REVIEW (notifies user)
-fulcrum current-task done          # Mark as DONE
-fulcrum current-task cancel        # Mark as CANCELED
-
-# Link a GitHub PR to the current task
-fulcrum current-task pr <github-pr-url>
-
-# Link a Linear ticket to the current task
-fulcrum current-task linear <linear-issue-url>
-
-# Add arbitrary URL links to the task
-fulcrum current-task link <url>                  # Add link (auto-detects type/label)
-fulcrum current-task link <url> --label "Docs"   # Add link with custom label
-fulcrum current-task link                        # List all links
-fulcrum current-task link --remove <url-or-id>   # Remove a link
-\`\`\`
-
-### tasks
-
-Manage tasks across the system:
-
-\`\`\`bash
-# List all tasks
-fulcrum tasks list
-fulcrum tasks list --status=IN_PROGRESS   # Filter by status
-fulcrum tasks list --search="ocai"        # Search by title, labels
-fulcrum tasks list --label="bug"          # Filter by label
-
-# List all labels in use
-fulcrum tasks labels                      # Show all labels with counts
-fulcrum tasks labels --search="comm"      # Find labels matching substring
-
-# Get a specific task
-fulcrum tasks get <task-id>
-
-# Create a new task
-fulcrum tasks create --title="My Task" --repo=/path/to/repo
-
-# Update task metadata
-fulcrum tasks update <task-id> --title="New Title"
-
-# Move task to different status
-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
-\`\`\`
-
-### notifications
-
-Send notifications to the user:
-
-\`\`\`bash
-# Send a notification
-fulcrum notify "Title" "Message body"
-
-# Check notification settings
-fulcrum notifications
-
-# Enable/disable notifications
-fulcrum notifications enable
-fulcrum notifications disable
-
-# Test a notification channel
-fulcrum notifications test sound
-fulcrum notifications test slack
-fulcrum notifications test discord
-fulcrum notifications test pushover
-
-# Configure a channel
-fulcrum notifications set slack webhookUrl <url>
-\`\`\`
-
-### Server Management
-
-\`\`\`bash
-fulcrum up          # Start Fulcrum server daemon
-fulcrum down        # Stop Fulcrum server
-fulcrum status      # Check if server is running
-fulcrum health      # Check server health
-\`\`\`
-
-### Git Operations
-
-\`\`\`bash
-fulcrum git status              # Git status for current worktree
-fulcrum git diff                # Git diff for current worktree
-fulcrum worktrees list          # List all worktrees
-\`\`\`
-
-### projects
-
-Manage projects (repositories with metadata):
-
-\`\`\`bash
-# List all projects
-fulcrum projects list
-fulcrum projects list --status=active    # Filter by status (active, archived)
-
-# Get project details
-fulcrum projects get <project-id>
-
-# Create a new project
-fulcrum projects create --name="My Project" --path=/path/to/repo          # From local path
-fulcrum projects create --name="My Project" --url=https://github.com/...  # Clone from URL
-fulcrum projects create --name="My Project" --repository-id=<repo-id>     # Link existing repo
-
-# Update project
-fulcrum projects update <project-id> --name="New Name"
-fulcrum projects update <project-id> --status=archived
-
-# Delete project
-fulcrum projects delete <project-id>
-fulcrum projects delete <project-id> --delete-directory   # Also delete directory
-fulcrum projects delete <project-id> --delete-app         # Also delete linked app
-
-# Scan for git repositories
-fulcrum projects scan                        # Scan default directory
-fulcrum projects scan --directory=/path      # Scan specific directory
-
-# Manage project links (URLs)
-fulcrum projects links list <project-id>
-fulcrum projects links add <project-id> <url> --label="Custom Label"
-fulcrum projects links remove <project-id> <link-id>
-\`\`\`
-
-### repositories
-
-Manage repositories (code sources that can be linked to projects):
-
-\`\`\`bash
-# List repositories
-fulcrum repositories list
-fulcrum repositories list --orphans          # Unlinked repos only
-fulcrum repositories list --project-id=<id>  # Filter by project
-
-# Get repository details
-fulcrum repositories get <repo-id>
-
-# Add a new repository from local path
-fulcrum repositories add --path=/path/to/repo
-fulcrum repositories add --path=/path/to/repo --display-name="My Repo"
-
-# Update repository
-fulcrum repositories update <repo-id> --display-name="New Name"
-fulcrum repositories update <repo-id> --default-agent=claude
-fulcrum repositories update <repo-id> --startup-script="mise run dev"
-fulcrum repositories update <repo-id> --copy-files=".env,.env.local"
-
-# Delete orphaned repository (fails if linked to a project)
-fulcrum repositories delete <repo-id>
-
-# Link repository to project (repos can only be linked to one project)
-fulcrum repositories link <repo-id> <project-id>
-fulcrum repositories link <repo-id> <project-id> --as-primary
-fulcrum repositories link <repo-id> <project-id> --force  # Move from existing project
-
-# Unlink repository from project
-fulcrum repositories unlink <repo-id> <project-id>
-\`\`\`
-
-### apps
-
-Manage Docker Compose app deployments:
-
-\`\`\`bash
-# List all apps
-fulcrum apps list
-fulcrum apps list --status=running   # Filter by status (stopped, building, running, failed)
-
-# Get app details
-fulcrum apps get <app-id>
-
-# Create a new app
-fulcrum apps create --name="My App" --repository-id=<repo-id>
-fulcrum apps create --name="My App" --repository-id=<repo-id> --branch=develop --auto-deploy
-
-# Update app
-fulcrum apps update <app-id> --name="New Name"
-fulcrum apps update <app-id> --auto-deploy      # Enable auto-deploy
-fulcrum apps update <app-id> --no-cache         # Enable no-cache builds
-
-# Deploy an app
-fulcrum apps deploy <app-id>
+# Deploy an app
+fulcrum apps deploy <app-id>
 
 # Stop an app
 fulcrum apps stop <app-id>
@@ -49361,257 +48329,1395 @@ Fulcrum provides a comprehensive set of MCP tools for AI agents. Use \`search_to
 
 ### Tool Discovery
 
-#### search_tools
+#### 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
+- \`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
+
+#### 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
+- \`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
+
+Clean up a session when you're done to free resources.
+
+## Best Practices
+
+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
+`;
+
+// cli/src/commands/claude.ts
+var PLUGIN_DIR = join3(homedir2(), ".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 }
+];
+var PLUGIN_ID = "fulcrum@fulcrum";
+var INSTALLED_PLUGINS_PATH = join3(homedir2(), ".claude", "plugins", "installed_plugins.json");
+var CLAUDE_SETTINGS_PATH = join3(homedir2(), ".claude", "settings.json");
+function getPluginVersion() {
+  try {
+    const parsed = JSON.parse(plugin_default);
+    return parsed.version || "1.0.0";
+  } catch {
+    return "1.0.0";
+  }
+}
+function registerPlugin() {
+  const version3 = getPluginVersion();
+  const now = new Date().toISOString();
+  let data = { version: 2, plugins: {} };
+  if (existsSync3(INSTALLED_PLUGINS_PATH)) {
+    try {
+      data = JSON.parse(readFileSync4(INSTALLED_PLUGINS_PATH, "utf-8"));
+    } catch {}
+  }
+  data.plugins = data.plugins || {};
+  data.plugins[PLUGIN_ID] = [
+    {
+      scope: "user",
+      installPath: PLUGIN_DIR,
+      version: version3,
+      installedAt: now,
+      lastUpdated: now
+    }
+  ];
+  const dir = INSTALLED_PLUGINS_PATH.substring(0, INSTALLED_PLUGINS_PATH.lastIndexOf("/"));
+  mkdirSync3(dir, { recursive: true });
+  writeFileSync3(INSTALLED_PLUGINS_PATH, JSON.stringify(data, null, 2), "utf-8");
+}
+function enablePlugin() {
+  let data = {};
+  if (existsSync3(CLAUDE_SETTINGS_PATH)) {
+    try {
+      data = JSON.parse(readFileSync4(CLAUDE_SETTINGS_PATH, "utf-8"));
+    } catch {}
+  }
+  const enabledPlugins = data.enabledPlugins || {};
+  enabledPlugins[PLUGIN_ID] = true;
+  data.enabledPlugins = enabledPlugins;
+  const dir = CLAUDE_SETTINGS_PATH.substring(0, CLAUDE_SETTINGS_PATH.lastIndexOf("/"));
+  mkdirSync3(dir, { recursive: true });
+  writeFileSync3(CLAUDE_SETTINGS_PATH, JSON.stringify(data, null, 2), "utf-8");
+}
+function unregisterPlugin() {
+  if (!existsSync3(INSTALLED_PLUGINS_PATH))
+    return;
+  try {
+    const data = JSON.parse(readFileSync4(INSTALLED_PLUGINS_PATH, "utf-8"));
+    if (data.plugins && data.plugins[PLUGIN_ID]) {
+      delete data.plugins[PLUGIN_ID];
+      writeFileSync3(INSTALLED_PLUGINS_PATH, JSON.stringify(data, null, 2), "utf-8");
+    }
+  } catch {}
+}
+function disablePlugin() {
+  if (!existsSync3(CLAUDE_SETTINGS_PATH))
+    return;
+  try {
+    const data = JSON.parse(readFileSync4(CLAUDE_SETTINGS_PATH, "utf-8"));
+    if (data.enabledPlugins && data.enabledPlugins[PLUGIN_ID] !== undefined) {
+      delete data.enabledPlugins[PLUGIN_ID];
+      writeFileSync3(CLAUDE_SETTINGS_PATH, JSON.stringify(data, null, 2), "utf-8");
+    }
+  } catch {}
+}
+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 installedPluginJson = join3(PLUGIN_DIR, ".claude-plugin", "plugin.json");
+  if (!existsSync3(installedPluginJson)) {
+    return true;
+  }
+  try {
+    const installed = JSON.parse(readFileSync4(installedPluginJson, "utf-8"));
+    const bundled = JSON.parse(plugin_default);
+    return installed.version !== bundled.version;
+  } catch {
+    return true;
+  }
+}
+async function installClaudePlugin(options = {}) {
+  const { silent = false } = options;
+  const log = silent ? () => {} : console.log;
+  try {
+    log("Installing Claude Code plugin...");
+    if (existsSync3(PLUGIN_DIR)) {
+      log("\u2022 Removing existing plugin installation...");
+      rmSync(PLUGIN_DIR, { recursive: true });
+    }
+    for (const file2 of PLUGIN_FILES) {
+      const fullPath = join3(PLUGIN_DIR, file2.path);
+      const dir = fullPath.substring(0, fullPath.lastIndexOf("/"));
+      mkdirSync3(dir, { recursive: true });
+      writeFileSync3(fullPath, file2.content, "utf-8");
+    }
+    log("\u2713 Installed plugin files at " + PLUGIN_DIR);
+    registerPlugin();
+    log("\u2713 Registered plugin in installed_plugins.json");
+    enablePlugin();
+    log("\u2713 Enabled plugin in settings.json");
+    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 {
+    let didSomething = false;
+    if (existsSync3(PLUGIN_DIR)) {
+      rmSync(PLUGIN_DIR, { recursive: true });
+      console.log("\u2713 Removed plugin files from " + PLUGIN_DIR);
+      didSomething = true;
+    }
+    unregisterPlugin();
+    console.log("\u2713 Unregistered plugin from installed_plugins.json");
+    disablePlugin();
+    console.log("\u2713 Disabled plugin in settings.json");
+    if (didSomething) {
+      console.log("");
+      console.log("Uninstall complete! Restart Claude Code to apply changes.");
+    } else {
+      console.log("");
+      console.log("Plugin files were not found, but registration entries have been cleaned up.");
+    }
+  } catch (err) {
+    throw new CliError("UNINSTALL_FAILED", `Failed to uninstall Claude plugin: ${err instanceof Error ? err.message : String(err)}`, ExitCodes.ERROR);
+  }
+}
+// package.json
+var package_default = {
+  name: "@knowsuchagency/fulcrum",
+  private: true,
+  version: "1.4.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 (existsSync4(join4(dir, "server", "index.js"))) {
+      return dir;
+    }
+    dir = dirname2(dir);
+  }
+  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);
+      }
+      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}
+
+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`);
+    }
+  }
+}
 
-Search for available tools by keyword or category:
+// 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);
+  }
+}
 
-\`\`\`json
-{
-  "query": "deploy",      // Optional: Search term
-  "category": "apps"      // Optional: Filter by category
+// 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);
+  }
 }
-\`\`\`
 
-**Categories:** core, tasks, projects, repositories, apps, filesystem, git, notifications, exec
+// 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);
+  }
+}
 
-**Example Usage:**
-\`\`\`
-search_tools { query: "project create" }
-\u2192 Returns tools for creating projects
+// 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 { category: "filesystem" }
-\u2192 Returns all filesystem 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"
 
-### Task Tools
+declare const process: { env: Record<string, string | undefined> }
 
-- \`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 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
+  }
+}
 
-#### Task Search and Filtering
+/**
+ * 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
 
-The \`list_tasks\` tool supports powerful filtering for AI agents:
+    const child = spawn(FULCRUM_CMD, args, { shell: true })
 
-\`\`\`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
-}
-\`\`\`
+    const cleanup = () => {
+      processExited = true
+      if (killTimeoutId) {
+        clearTimeout(killTimeoutId)
+        killTimeoutId = null
+      }
+    }
 
-#### Label Discovery
+    child.stdout?.on('data', (data) => {
+      stdout += data.toString()
+    })
 
-Use \`list_labels\` to discover exact label names before filtering:
+    child.stderr?.on('data', (data) => {
+      stderr += data.toString()
+    })
 
-\`\`\`json
-// Find labels matching "communication"
-{ "search": "communication" }
-// Returns: [{ "name": "communication required", "count": 5 }]
-\`\`\`
+    child.on('close', (code) => {
+      cleanup()
+      if (!resolved) {
+        resolved = true
+        resolve({ exitCode: code || 0, stdout, stderr })
+      }
+    })
 
-This helps handle typos and variations - search first, then use the exact label name.
+    child.on('error', (err) => {
+      cleanup()
+      if (!resolved) {
+        resolved = true
+        resolve({ exitCode: 1, stdout, stderr: err.message || '' })
+      }
+    })
 
-### Project Tools
+    // 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)
 
-- \`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
+    // Clear timeout if command completes
+    child.on('exit', () => clearTimeout(timeoutId))
+  })
+}
 
-### Repository 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_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
+const FULCRUM_CMD = "fulcrum"
+const IDLE_CONFIRMATION_DELAY_MS = 1500
+const FULCRUM_COMMAND_TIMEOUT_MS = 10000
+const STATUS_CHANGE_DEBOUNCE_MS = 500
 
-### App/Deployment Tools
+let deferredContextCheck: Promise<boolean> | null = null
+let isFulcrumContext: boolean | null = null
+let pendingStatusCommand: Promise<{ exitCode: number; stdout: string; stderr: string }> | null = null
 
-- \`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
+export const FulcrumPlugin: Plugin = async ({ $, directory }) => {
+  log("Plugin initializing...")
 
-### Filesystem 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
+      })
+  }
 
-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).
+  log("Plugin hooks registered")
 
-- \`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 checkContext = async (): Promise<boolean> => {
+    if (isFulcrumContext !== null) return isFulcrumContext
+    if (deferredContextCheck) {
+      isFulcrumContext = await deferredContextCheck
+      deferredContextCheck = null
+      return isFulcrumContext
+    }
+    return false
+  }
 
-### Command Execution
+  const cancelPendingIdle = () => {
+    if (pendingIdleTimer) {
+      clearTimeout(pendingIdleTimer)
+      pendingIdleTimer = null
+      log("Cancelled pending idle transition")
+    }
+  }
 
-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.
+  const setStatus = (status: "in-progress" | "review") => {
+    if (status === lastStatus) return
 
-#### execute_command
+    cancelPendingIdle()
 
-Execute shell commands with optional persistent session support:
+    if (pendingStatusCommand) {
+      log(\`Status change already in progress, will retry after \${STATUS_CHANGE_DEBOUNCE_MS}ms\`)
+      setTimeout(() => setStatus(status), STATUS_CHANGE_DEBOUNCE_MS)
+      return
+    }
 
-\`\`\`json
-{
-  "command": "echo hello world",
-  "sessionId": "optional-session-id",
-  "cwd": "/path/to/start",
-  "timeout": 30000,
-  "name": "my-session"
-}
-\`\`\`
+    lastStatus = status
 
-**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)
+    ;(async () => {
+      try {
+        log(\`Setting status: \${status}\`)
+        pendingStatusCommand = runFulcrumCommand(['current-task', status, '--path', directory])
+        const res = await pendingStatusCommand
+        pendingStatusCommand = null
 
-**Response:**
-\`\`\`json
-{
-  "sessionId": "uuid",
-  "stdout": "hello world",
-  "stderr": "",
-  "exitCode": 0,
-  "timedOut": false
-}
-\`\`\`
+        if (res.exitCode !== 0) {
+          log(\`Status update failed: exitCode=\${res.exitCode}, stderr=\${res.stderr}\`)
+        }
+      } catch (e) {
+        log(\`Status update error: \${e}\`)
+        pendingStatusCommand = null
+      }
+    })()
+  }
 
-### Session Workflow Example
+  const scheduleIdleTransition = () => {
+    cancelPendingIdle()
+    const currentVersion = ++activityVersion
 
-\`\`\`
-1. First command (creates named session):
-   execute_command { command: "cd /project && export API_KEY=secret", name: "dev-session" }
-   \u2192 Returns sessionId: "abc-123"
+    pendingIdleTimer = setTimeout(() => {
+      if (activityVersion !== currentVersion) {
+        log(
+          \`Stale idle transition (version \${currentVersion} vs \${activityVersion})\`,
+        )
+        return
+      }
+      setStatus("review")
+    }, IDLE_CONFIRMATION_DELAY_MS)
 
-2. Subsequent commands (reuse session):
-   execute_command { command: "echo $API_KEY", sessionId: "abc-123" }
-   \u2192 Returns stdout: "secret" (env var preserved)
+    log(
+      \`Scheduled idle transition (version \${currentVersion}, delay \${IDLE_CONFIRMATION_DELAY_MS}ms)\`,
+    )
+  }
 
-   execute_command { command: "pwd", sessionId: "abc-123" }
-   \u2192 Returns stdout: "/project" (cwd preserved)
+  const recordActivity = (reason: string) => {
+    activityVersion++
+    cancelPendingIdle()
+    log(\`Activity: \${reason} (version now \${activityVersion})\`)
+  }
 
-3. Rename session if needed:
-   update_exec_session { sessionId: "abc-123", name: "new-name" }
+  return {
+    "chat.message": async (_input, output) => {
+      if (!(await checkContext())) return
 
-4. Cleanup when done:
-   destroy_exec_session { sessionId: "abc-123" }
-\`\`\`
+      if (output.message.role === "user") {
+        recordActivity("user message")
+        setStatus("in-progress")
+      } else if (output.message.role === "assistant") {
+        recordActivity("assistant message")
+      }
+    },
 
-Sessions persist until manually destroyed.
+    event: async ({ event }) => {
+      if (!NOISY_EVENTS.has(event.type)) {
+        log(\`Event: \${event.type}\`)
+      }
 
-### list_exec_sessions
+      if (!(await checkContext())) return
 
-List all active sessions with their name, current working directory, and timestamps.
+      const props = (event.properties as Record<string, unknown>) || {}
 
-### update_exec_session
+      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
 
-Rename an existing session for identification.
+        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}\`)
+        }
 
-### destroy_exec_session
+        recordActivity("session.created")
+        setStatus("in-progress")
+        return
+      }
 
-Clean up a session when you're done to free resources.
+      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
+      }
 
-## Best Practices
+      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
 
-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
+        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/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_DIR2 = join5(homedir3(), ".config", "opencode", "plugin");
+var PLUGIN_PATH = join5(PLUGIN_DIR2, "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_DIR2, { 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("Nothing to uninstall. Plugin not found at " + PLUGIN_DIR2);
+      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 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