cortex-agents 2.3.1 → 4.0.0

package/dist/cli.js

@@ -3,8 +3,8 @@ import * as fs from "fs";
 import * as path from "path";
 import { fileURLToPath } from "url";
 import prompts from "prompts";
-import { PRIMARY_AGENTS, SUBAGENTS, ALL_AGENTS, getPrimaryChoices, getSubagentChoices, } from "./registry.js";
-const VERSION = "2.3.0";
+import { PRIMARY_AGENTS, SUBAGENTS, ALL_AGENTS, DISABLED_BUILTIN_AGENTS, STALE_AGENT_FILES, getPrimaryChoices, getSubagentChoices, } from "./registry.js";
+const VERSION = "4.0.0";
 const PLUGIN_NAME = "cortex-agents";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -138,6 +138,23 @@ function installAgentsAndSkills(targetDir) {
         console.log(`  Installed ${count} skills -> ${skillsDest}`);
     }
 }
+function cleanupStaleAgents(globalDir) {
+    const agentsDir = path.join(globalDir, "agents");
+    if (!fs.existsSync(agentsDir))
+        return;
+    for (const file of STALE_AGENT_FILES) {
+        const filePath = path.join(agentsDir, file);
+        try {
+            if (fs.existsSync(filePath)) {
+                fs.unlinkSync(filePath);
+                console.log(`  Cleaned up stale agent: ${file}`);
+            }
+        }
+        catch (err) {
+            console.warn(`  Warning: Could not remove stale agent ${file}: ${err.message}`);
+        }
+    }
+}
 function removeAgentsAndSkills(targetDir) {
     const agentsSrc = path.join(PACKAGE_OPENCODE_DIR, "agents");
     const skillsSrc = path.join(PACKAGE_OPENCODE_DIR, "skills");
@@ -173,9 +190,15 @@ function install() {
             fs.mkdirSync(globalDir, { recursive: true });
         }
         const globalPath = path.join(globalDir, "opencode.json");
+        const disabledAgents = {};
+        for (const name of DISABLED_BUILTIN_AGENTS) {
+            disabledAgents[name] = { disable: true };
+        }
         const newConfig = {
             $schema: "https://opencode.ai/config.json",
             plugin: [PLUGIN_NAME],
+            default_agent: "architect",
+            agent: disabledAgents,
         };
         writeConfig(globalPath, newConfig);
         console.log(`Created config: ${globalPath}`);
@@ -187,16 +210,26 @@ function install() {
             config.plugin = [];
         if (!config.plugin.includes(PLUGIN_NAME)) {
             config.plugin.push(PLUGIN_NAME);
-            writeConfig(configInfo.path, config);
-            console.log(`Added plugin to config: ${configInfo.path}\n`);
         }
-        else {
-            console.log(`Plugin already in config: ${configInfo.path}\n`);
+        // Disable built-in agents that cortex-agents replaces
+        if (!config.agent)
+            config.agent = {};
+        for (const name of DISABLED_BUILTIN_AGENTS) {
+            if (!config.agent[name])
+                config.agent[name] = {};
+            config.agent[name].disable = true;
         }
+        // Set default_agent, clean legacy camelCase key
+        config.default_agent = "architect";
+        delete config.defaultAgent;
+        writeConfig(configInfo.path, config);
+        console.log(`Updated config: ${configInfo.path}\n`);
     }
     // Copy agents and skills into the global opencode config dir
     console.log("Installing agents and skills...");
     installAgentsAndSkills(globalDir);
+    // Clean up stale agent files from previous cortex-agents versions
+    cleanupStaleAgents(globalDir);
     // Sync per-project models if .opencode/models.json exists
     if (hasProjectModelsConfig()) {
         console.log("\nPer-project model config found (.opencode/models.json)");
@@ -233,11 +266,23 @@ function uninstall() {
                 }
             }
         }
+        // Re-enable built-in agents
+        for (const name of DISABLED_BUILTIN_AGENTS) {
+            if (config.agent[name]) {
+                delete config.agent[name].disable;
+                if (Object.keys(config.agent[name]).length === 0) {
+                    delete config.agent[name];
+                }
+            }
+        }
         // Clean up empty agent object
         if (Object.keys(config.agent).length === 0) {
             delete config.agent;
         }
     }
+    // Remove default_agent + clean legacy key
+    delete config.default_agent;
+    delete config.defaultAgent;
     writeConfig(configInfo.path, config);
     // Remove agents and skills
     const globalDir = getGlobalDir();
@@ -276,6 +321,12 @@ async function configure() {
             config.plugin = [];
         config.plugin.push(PLUGIN_NAME);
     }
+    // Set default agent to architect (planning-first workflow)
+    if (!config.default_agent) {
+        config.default_agent = "architect";
+    }
+    // Clean legacy camelCase key
+    delete config.defaultAgent;
     // ── Primary model selection ────────────────────────────────
     const { primary, subagent } = await promptModelSelection();
     // ── Write config ───────────────────────────────────────────
@@ -283,6 +334,14 @@ async function configure() {
         // Per-project: write .opencode/models.json + sync to local opencode.json
         writeProjectModels(primary, subagent);
         syncProjectModelsToConfig();
+        // Ensure default agent is set in local opencode.json
+        const localConfig = readConfig(path.join(process.cwd(), "opencode.json"));
+        if (!localConfig.default_agent) {
+            localConfig.default_agent = "architect";
+        }
+        // Clean legacy camelCase key
+        delete localConfig.defaultAgent;
+        writeConfig(path.join(process.cwd(), "opencode.json"), localConfig);
         const modelsPath = getProjectModelsPath();
         const localConfigPath = path.join(process.cwd(), "opencode.json");
         console.log("━".repeat(50));
@@ -304,6 +363,12 @@ async function configure() {
                 config.agent[name] = {};
             config.agent[name].model = subagent;
         }
+        // Re-assert disable entries for built-in agents
+        for (const name of DISABLED_BUILTIN_AGENTS) {
+            if (!config.agent[name])
+                config.agent[name] = {};
+            config.agent[name].disable = true;
+        }
         const targetPath = configInfo?.path || path.join(getGlobalDir(), "opencode.json");
         writeConfig(targetPath, config);
         console.log("━".repeat(50));
@@ -330,7 +395,7 @@ async function promptModelSelection() {
         description: "provider/model format",
         value: "__custom__",
     });
-    console.log("Primary agents (build, plan, debug, review) handle complex tasks.\nUse your best available model.\n");
+    console.log("Primary agents (architect, implement, fix) handle complex tasks.\nUse your best available model.\n");
     const { primaryModel } = await prompts({
         type: "select",
         name: "primaryModel",
@@ -364,7 +429,7 @@ async function promptModelSelection() {
         description: "provider/model format",
         value: "__custom__",
     });
-    console.log("Subagents (fullstack, testing, security, devops) handle focused tasks.\nA faster/cheaper model works great here.\n");
+    console.log("Subagents (debug, coder, testing, security, devops, audit) handle focused tasks.\nA faster/cheaper model works great here.\n");
     const { subagentModel } = await prompts({
         type: "select",
         name: "subagentModel",
@@ -566,18 +631,17 @@ EXAMPLES:
   npx ${PLUGIN_NAME} status                     # Check status
 
 AGENTS:
-  Primary (build, plan, debug, review):
+  Primary (architect, implement, fix):
     Handle complex tasks — select your best model.
 
-  Subagents (fullstack, testing, security, devops):
+  Subagents (debug, coder, testing, security, devops, audit):
     Handle focused tasks — a fast/cheap model works great.
 
-TOOLS (23):
+TOOLS (29):
   cortex_init, cortex_status      .cortex directory management
   cortex_configure                Per-project model configuration
   worktree_create, worktree_list  Git worktree management
   worktree_remove, worktree_open
-  worktree_launch                 Launch worktree (terminal/PTY/background)
   branch_create, branch_status    Git branch operations
   branch_switch
   plan_save, plan_list            Plan persistence
@@ -587,13 +651,17 @@ TOOLS (23):
   docs_init, docs_save            Mermaid documentation
   docs_list, docs_index
   task_finalize                   Commit, push, and create PR
+  github_status, github_issues    GitHub issue and project browsing
+  github_projects
+  repl_init, repl_status          Iterative task-by-task implementation loop
+  repl_report, repl_summary
 
 SKILLS (14):
-  web-development, frontend-development, backend-development,
-  mobile-development, desktop-development, database-design,
-  api-design, architecture-patterns, design-patterns,
-  testing-strategies, security-hardening, deployment-automation,
-  performance-optimization, code-quality, git-workflow
+  frontend-development, backend-development, mobile-development,
+  desktop-development, database-design, api-design,
+  architecture-patterns, design-patterns, testing-strategies,
+  security-hardening, deployment-automation, performance-optimization,
+  code-quality, git-workflow
 `);
 }
 // ─── CLI Entry Point ─────────────────────────────────────────────────────────

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAmJlD,eAAO,MAAM,YAAY,EAAE,MAuJ1B,CAAC;AAGF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA+LlD,eAAO,MAAM,YAAY,EAAE,MAkJ1B,CAAC;AAGF,eAAe,YAAY,CAAC"}

package/dist/index.js

@@ -6,15 +6,23 @@ import * as plan from "./tools/plan";
 import * as session from "./tools/session";
 import * as docs from "./tools/docs";
 import * as task from "./tools/task";
+import * as github from "./tools/github";
+import * as repl from "./tools/repl";
+import * as qualityGate from "./tools/quality-gate";
 // ─── Agent Descriptions (for handover toasts) ───────────────────────────────
 const AGENT_DESCRIPTIONS = {
-    build: "Development mode — ready to implement",
-    plan: "Planning mode — read-only analysis",
-    debug: "Debug mode — troubleshooting and fixes",
-    fullstack: "Fullstack subagent — end-to-end implementation",
+    implement: "Development mode — ready to implement",
+    architect: "Planning mode — read-only analysis",
+    fix: "Quick fix mode — fast turnaround",
+    debug: "Debug subagent — root cause analysis",
+    coder: "Coder subagent — multi-layer implementation",
     testing: "Testing subagent — writing tests",
     security: "Security subagent — vulnerability audit",
     devops: "DevOps subagent — CI/CD and deployment",
+    audit: "Audit subagent — code quality assessment",
+    refactor: "Refactor subagent — behavior-preserving restructuring",
+    "docs-writer": "Docs subagent — documentation generation",
+    perf: "Perf subagent — performance analysis",
 };
 const TOOL_NOTIFICATIONS = {
     task_finalize: {
@@ -40,6 +48,7 @@ const TOOL_NOTIFICATIONS = {
         errorTitle: "Plan Delete Failed",
         errorMsg: (_, out) => out.substring(0, 100),
     },
+    // plan_commit — excluded: uses factory-based toasts in createCommit()
     session_save: {
         successTitle: "Session Saved",
         successMsg: () => "Session summary recorded",
@@ -79,6 +88,40 @@ const TOOL_NOTIFICATIONS = {
             .split("\n")[0]
             .substring(0, 100),
     },
+    github_status: {
+        successTitle: "GitHub Connected",
+        successMsg: (_args, output) => {
+            const repoMatch = output.match(/Repository:\s+(.+)/);
+            return repoMatch ? `Connected to ${repoMatch[1].substring(0, 100)}` : "GitHub CLI available";
+        },
+        errorTitle: "GitHub Not Available",
+        errorMsg: (_, out) => out
+            .replace(/^✗\s*/, "")
+            .split("\n")[0]
+            .substring(0, 100),
+    },
+    repl_init: {
+        successTitle: "REPL Loop Started",
+        successMsg: (args) => `${(args.planFilename ?? "Plan").split("/").pop()?.substring(0, 40)} — tasks loaded`,
+        errorTitle: "REPL Init Failed",
+        errorMsg: (_, out) => out.substring(0, 100),
+    },
+    repl_report: {
+        successTitle: "Task Update",
+        successMsg: (args) => `Result: ${args.result ?? "reported"}`,
+        errorTitle: "Report Failed",
+        errorMsg: (_, out) => out.substring(0, 100),
+    },
+    quality_gate_summary: {
+        successTitle: "Quality Gate",
+        successMsg: (_args, output) => {
+            const recMatch = output.match(/\*\*Recommendation:\s*(GO|NO-GO|GO-WITH-WARNINGS)\*\*/);
+            return recMatch ? `Recommendation: ${recMatch[1]}` : "Summary generated";
+        },
+        errorTitle: "Quality Gate Failed",
+        errorMsg: (_, out) => out.substring(0, 100),
+        successDuration: 5000,
+    },
 };
 // ─── Error Message Extraction ────────────────────────────────────────────────
 //
@@ -117,7 +160,6 @@ export const CortexPlugin = async (ctx) => {
             worktree_list: worktree.list,
             worktree_remove: worktree.createRemove(ctx.client),
             worktree_open: worktree.open,
-            worktree_launch: worktree.createLaunch(ctx.client, ctx.$),
             // Branch tools - git branch operations (factory for toast notifications)
             branch_create: branch.createCreate(ctx.client),
             branch_status: branch.status,
@@ -127,6 +169,7 @@ export const CortexPlugin = async (ctx) => {
             plan_list: plan.list,
             plan_load: plan.load,
             plan_delete: plan.delete_,
+            plan_commit: plan.createCommit(ctx.client),
             // Session tools - session summaries with decisions
             session_save: session.save,
             session_list: session.list,
@@ -138,6 +181,18 @@ export const CortexPlugin = async (ctx) => {
             docs_index: docs.index,
             // Task tools - finalize workflow (commit, push, PR)
             task_finalize: task.finalize,
+            // GitHub integration tools - work item listing, issue selection, project boards
+            github_status: github.status,
+            github_issues: github.issues,
+            github_projects: github.projects,
+            // REPL loop tools - iterative task-by-task implementation
+            repl_init: repl.init,
+            repl_status: repl.status,
+            repl_report: repl.report,
+            repl_resume: repl.resume,
+            repl_summary: repl.summary,
+            // Quality gate aggregation tool
+            quality_gate_summary: qualityGate.qualityGateSummary,
         },
         // ── Post-execution toast notifications ────────────────────────────────
         //
@@ -216,23 +271,6 @@ export const CortexPlugin = async (ctx) => {
                         },
                     });
                 }
-                // PTY exited notifications (relevant for worktree terminal sessions)
-                if (event.type === "pty.exited") {
-                    const rawExitCode = event.properties.exitCode;
-                    const exitCode = typeof rawExitCode === "number" && Number.isInteger(rawExitCode)
-                        ? rawExitCode
-                        : -1;
-                    await ctx.client.tui.showToast({
-                        body: {
-                            title: "Terminal Exited",
-                            message: exitCode === 0
-                                ? "Terminal session completed successfully"
-                                : `Terminal exited with code ${exitCode}`,
-                            variant: exitCode === 0 ? "success" : "warning",
-                            duration: exitCode === 0 ? 4000 : 8000,
-                        },
-                    });
-                }
             }
             catch {
                 // Toast failure is non-fatal — silently ignore

package/dist/registry.d.ts

@@ -19,11 +19,16 @@ export interface ModelEntry {
 }
 export declare const MODEL_REGISTRY: ModelEntry[];
 /** Primary agents receive the best available model */
-export declare const PRIMARY_AGENTS: readonly ["build", "plan", "debug", "review"];
+export declare const PRIMARY_AGENTS: readonly ["architect", "implement", "fix"];
 /** Subagents receive a fast/cost-effective model */
-export declare const SUBAGENTS: readonly ["fullstack", "testing", "security", "devops"];
+export declare const SUBAGENTS: readonly ["debug", "coder", "testing", "security", "devops", "audit", "refactor", "docs-writer", "perf"];
 /** All agent names combined */
-export declare const ALL_AGENTS: readonly ["build", "plan", "debug", "review", "fullstack", "testing", "security", "devops"];
+export declare const ALL_AGENTS: readonly ["architect", "implement", "fix", "debug", "coder", "testing", "security", "devops", "audit", "refactor", "docs-writer", "perf"];
+/** OpenCode built-in agents disabled when cortex-agents is installed.
+ *  Replaced by cortex equivalents: build → implement, plan → architect */
+export declare const DISABLED_BUILTIN_AGENTS: readonly ["build", "plan"];
+/** Old agent files to clean up from previous cortex-agents versions */
+export declare const STALE_AGENT_FILES: readonly ["build.md", "plan.md", "review.md", "fullstack.md", "crosslayer.md", "qa.md", "guard.md", "ship.md"];
 /**
  * Build the interactive choices list for primary model selection.
  * Shows premium and standard tier models (excluding fast).

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACtC,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,UAAU,EAuGtC,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,cAAc,+CAAgD,CAAC;AAE5E,oDAAoD;AACpD,eAAO,MAAM,SAAS,yDAA0D,CAAC;AAEjF,+BAA+B;AAC/B,eAAO,MAAM,UAAU,6FAA6C,CAAC;AAErE;;;GAGG;AACH,wBAAgB,iBAAiB;;;;IAMhC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM;;;;IAcxD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACtC,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,UAAU,EAuGtC,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,cAAc,4CAA6C,CAAC;AAEzE,oDAAoD;AACpD,eAAO,MAAM,SAAS,0GAA2G,CAAC;AAElI,+BAA+B;AAC/B,eAAO,MAAM,UAAU,2IAA6C,CAAC;AAErE;0EAC0E;AAC1E,eAAO,MAAM,uBAAuB,4BAA6B,CAAC;AAElE,uEAAuE;AACvE,eAAO,MAAM,iBAAiB,gHASpB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,iBAAiB;;;;IAMhC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM;;;;IAcxD"}

package/dist/registry.js

@@ -105,11 +105,25 @@ export const MODEL_REGISTRY = [
     },
 ];
 /** Primary agents receive the best available model */
-export const PRIMARY_AGENTS = ["build", "plan", "debug", "review"];
+export const PRIMARY_AGENTS = ["architect", "implement", "fix"];
 /** Subagents receive a fast/cost-effective model */
-export const SUBAGENTS = ["fullstack", "testing", "security", "devops"];
+export const SUBAGENTS = ["debug", "coder", "testing", "security", "devops", "audit", "refactor", "docs-writer", "perf"];
 /** All agent names combined */
 export const ALL_AGENTS = [...PRIMARY_AGENTS, ...SUBAGENTS];
+/** OpenCode built-in agents disabled when cortex-agents is installed.
+ *  Replaced by cortex equivalents: build → implement, plan → architect */
+export const DISABLED_BUILTIN_AGENTS = ["build", "plan"];
+/** Old agent files to clean up from previous cortex-agents versions */
+export const STALE_AGENT_FILES = [
+    "build.md",
+    "plan.md",
+    "review.md",
+    "fullstack.md",
+    "crosslayer.md",
+    "qa.md",
+    "guard.md",
+    "ship.md",
+];
 /**
  * Build the interactive choices list for primary model selection.
  * Shows premium and standard tier models (excluding fast).

package/dist/tools/branch.d.ts

@@ -9,10 +9,10 @@ export declare function createCreate(client: Client): {
     args: {
         name: import("zod").ZodString;
         type: import("zod").ZodEnum<{
+            refactor: "refactor";
             feature: "feature";
             bugfix: "bugfix";
             hotfix: "hotfix";
-            refactor: "refactor";
             docs: "docs";
             test: "test";
             chore: "chore";
@@ -20,7 +20,7 @@ export declare function createCreate(client: Client): {
     };
     execute(args: {
         name: string;
-        type: "feature" | "bugfix" | "hotfix" | "refactor" | "docs" | "test" | "chore";
+        type: "refactor" | "feature" | "bugfix" | "hotfix" | "docs" | "test" | "chore";
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
 };
 export declare const status: {

package/dist/tools/cortex.d.ts

@@ -12,8 +12,8 @@ export declare const status: {
 /**
  * cortex_configure — Write per-project model configuration to ./opencode.json.
  *
- * Accepts a primary model (for build/plan/debug) and a subagent model
- * (for fullstack/testing/security/devops). Merges into any existing
+ * Accepts a primary model (for implement/architect/fix/audit) and a subagent model
+ * (for crosslayer/qa/guard/ship). Merges into any existing
  * opencode.json at the project root, preserving other settings.
  */
 export declare const configure: {

package/dist/tools/cortex.js

@@ -151,13 +151,13 @@ Plans: ${planCount}`;
 /**
  * cortex_configure — Write per-project model configuration to ./opencode.json.
  *
- * Accepts a primary model (for build/plan/debug) and a subagent model
- * (for fullstack/testing/security/devops). Merges into any existing
+ * Accepts a primary model (for implement/architect/fix/audit) and a subagent model
+ * (for crosslayer/qa/guard/ship). Merges into any existing
  * opencode.json at the project root, preserving other settings.
  */
 export const configure = tool({
     description: "Save per-project model configuration to ./opencode.json. " +
-        "Sets the model for primary agents (build, plan, debug) and subagents (fullstack, testing, security, devops). " +
+        "Sets the model for primary agents (implement, architect, fix, audit) and subagents (crosslayer, qa, guard, ship). " +
         "Available models — Premium: " +
         MODEL_REGISTRY.filter((m) => m.tier === "premium")
             .map((m) => `${m.name} (${m.id})`)
@@ -174,10 +174,10 @@ export const configure = tool({
     args: {
         primaryModel: z
             .string()
-            .describe("Model ID for primary agents (build, plan, debug). Format: provider/model-name"),
+            .describe("Model ID for primary agents (implement, architect, fix, audit). Format: provider/model-name"),
         subagentModel: z
             .string()
-            .describe("Model ID for subagents (fullstack, testing, security, devops). Format: provider/model-name"),
+            .describe("Model ID for subagents (crosslayer, qa, guard, ship). Format: provider/model-name"),
     },
     async execute(args, context) {
         const configPath = path.join(context.worktree, "opencode.json");
@@ -246,10 +246,10 @@ export const configure = tool({
         return `✓ Model configuration saved to:
   ${savedTo}
 
-Primary agents (build, plan, debug):
+Primary agents (implement, architect, fix, audit):
   → ${primaryDisplay} (${args.primaryModel})
 
-Subagents (fullstack, testing, security, devops):
+Subagents (crosslayer, qa, guard, ship):
   → ${subagentDisplay} (${args.subagentModel})
 
 Restart OpenCode to apply changes.`;

package/dist/tools/docs.d.ts

@@ -35,13 +35,13 @@ export declare const list: {
     args: {
         type: import("zod").ZodOptional<import("zod").ZodEnum<{
             feature: "feature";
-            all: "all";
             decision: "decision";
+            all: "all";
             flow: "flow";
         }>>;
     };
     execute(args: {
-        type?: "feature" | "all" | "decision" | "flow" | undefined;
+        type?: "feature" | "decision" | "all" | "flow" | undefined;
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
 };
 export declare const index: {

package/dist/tools/environment.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Environment Detection Tool
+ *
+ * Provides agents with information about the current development environment
+ * (IDE, terminal, editor) to offer contextually appropriate worktree launch options.
+ *
+ * Uses two detection systems:
+ *   - IDE detection (ide.ts) — for "Open in IDE" options
+ *   - Terminal detection (terminal.ts) — for "Open in terminal tab" options
+ *
+ * The terminal detection uses a multi-strategy chain:
+ *   1. Environment variables (fast, synchronous)
+ *   2. Process-tree walk (finds terminal in parent processes)
+ *   3. Frontmost app detection (macOS only)
+ *   4. User preference (.cortex/config.json)
+ */
+export declare const detectEnvironment: {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Quick environment check tool for agents.
+ * Returns a simplified response for quick decision-making.
+ */
+export declare const getEnvironmentInfo: {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+//# sourceMappingURL=environment.d.ts.map

package/dist/tools/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/tools/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,eAAO,MAAM,iBAAiB;;;;CAgD5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;CA4B7B,CAAC"}

package/dist/tools/environment.js

@@ -0,0 +1,93 @@
+/**
+ * Environment Detection Tool
+ *
+ * Provides agents with information about the current development environment
+ * (IDE, terminal, editor) to offer contextually appropriate worktree launch options.
+ *
+ * Uses two detection systems:
+ *   - IDE detection (ide.ts) — for "Open in IDE" options
+ *   - Terminal detection (terminal.ts) — for "Open in terminal tab" options
+ *
+ * The terminal detection uses a multi-strategy chain:
+ *   1. Environment variables (fast, synchronous)
+ *   2. Process-tree walk (finds terminal in parent processes)
+ *   3. Frontmost app detection (macOS only)
+ *   4. User preference (.cortex/config.json)
+ */
+import { tool } from "@opencode-ai/plugin";
+import { detectIDEWithCLICheck, formatEnvironmentReport, generateEnvironmentRecommendations } from "../utils/ide.js";
+import { detectDriver, detectTerminalDriver } from "../utils/terminal.js";
+export const detectEnvironment = tool({
+    description: "Detect the current development environment (IDE, terminal, editor) " +
+        "to offer contextually appropriate worktree launch options. " +
+        "Returns environment info and recommended launch options.",
+    args: {},
+    async execute(args, context) {
+        // Use async detection that verifies CLI availability in PATH
+        const ide = await detectIDEWithCLICheck();
+        const ideDriver = detectDriver();
+        // Multi-strategy terminal detection (the one used for "Open in terminal tab")
+        const terminalDetection = await detectTerminalDriver(context.worktree);
+        // Format the report (now includes CLI availability status)
+        const report = formatEnvironmentReport(ide, terminalDetection.driver.name);
+        // Add CLI status section
+        const additionalInfo = [];
+        additionalInfo.push(``, `### CLI Status`, ``);
+        additionalInfo.push(`- IDE: ${ide.name}`);
+        additionalInfo.push(`- IDE Driver: ${ideDriver.name}`);
+        additionalInfo.push(`- Terminal Emulator: **${terminalDetection.driver.name}**`);
+        additionalInfo.push(`- Platform: ${process.platform}`);
+        if (ide.cliBinary) {
+            if (ide.cliAvailable) {
+                additionalInfo.push(`- CLI: \`${ide.cliBinary}\` available in PATH`);
+            }
+            else {
+                additionalInfo.push(`- CLI: \`${ide.cliBinary}\` **NOT found** in PATH`);
+                if (ide.cliInstallHint) {
+                    additionalInfo.push(`- Fix: ${ide.cliInstallHint}`);
+                }
+            }
+        }
+        // Terminal detection details
+        additionalInfo.push(``, `### Terminal Detection`, ``);
+        additionalInfo.push(`- Strategy: **${terminalDetection.strategy}**`);
+        if (terminalDetection.detail) {
+            additionalInfo.push(`- Detail: ${terminalDetection.detail}`);
+        }
+        additionalInfo.push(`- Driver: ${terminalDetection.driver.name}`);
+        additionalInfo.push(``);
+        additionalInfo.push(`When "Open in terminal tab" is selected, a new tab will open in **${terminalDetection.driver.name}**.`);
+        return report + additionalInfo.join("\n");
+    },
+});
+/**
+ * Quick environment check tool for agents.
+ * Returns a simplified response for quick decision-making.
+ */
+export const getEnvironmentInfo = tool({
+    description: "Get quick environment info for deciding worktree launch options. " +
+        "Returns IDE type, terminal name, and whether to offer IDE-specific options.",
+    args: {},
+    async execute(args, context) {
+        const ide = await detectIDEWithCLICheck();
+        const terminalDetection = await detectTerminalDriver(context.worktree);
+        return JSON.stringify({
+            ide: {
+                type: ide.type,
+                name: ide.name,
+                hasIntegratedTerminal: ide.hasIntegratedTerminal,
+                canOpenInWindow: ide.canOpenInWindow,
+                cliAvailable: ide.cliAvailable,
+                cliBinary: ide.cliBinary,
+                cliInstallHint: ide.cliInstallHint,
+            },
+            terminal: {
+                name: terminalDetection.driver.name,
+                detectionStrategy: terminalDetection.strategy,
+                detectionDetail: terminalDetection.detail,
+            },
+            platform: process.platform,
+            recommendations: generateEnvironmentRecommendations(ide),
+        }, null, 2);
+    },
+});