cortex-agents 2.2.0 → 2.3.1

package/README.md

@@ -43,7 +43,7 @@ npx cortex-agents configure     # Pick your models interactively
 # Restart OpenCode - done.
 ```
 
-That's it. Your OpenCode session now has 7 specialized agents, 22 tools, and 14 domain skills.
+That's it. Your OpenCode session now has 8 specialized agents, 23 tools, and 14 domain skills.
 
 <br>
 
@@ -78,6 +78,8 @@ Create isolated development environments and launch them instantly:
 
 Plans are automatically propagated into the worktree's `.cortex/plans/` so the new session has full context.
 
+**Cross-platform terminal support** via the terminal driver system — automatically detects and integrates with tmux, iTerm2, Terminal.app, kitty, wezterm, Konsole, and GNOME Terminal. Tabs opened by the launcher are tracked and automatically closed when the worktree is removed.
+
 ### Task Finalizer
 
 One tool to close the loop:
@@ -114,35 +116,48 @@ Handle complex, multi-step work. Use your best model.
 
 | Agent | Role | Superpower |
 |-------|------|-----------|
-| **build** | Full-access development | Two-step branching strategy, worktree launcher, task finalizer, docs prompting |
-| **plan** | Read-only analysis | Creates implementation plans with mermaid diagrams, hands off to build |
-| **debug** | Deep troubleshooting | Full bash/edit access with hotfix workflow |
+| **build** | Full-access development | Skill-aware implementation, worktree launcher, quality gates, task finalizer |
+| **plan** | Read-only analysis | Architectural plans with mermaid diagrams, NFR analysis, hands off to build |
+| **debug** | Deep troubleshooting | Performance debugging, distributed tracing, hotfix workflow |
+| **review** | Code quality assessment | Tech debt scoring, pattern review, refactoring advisor (read-only) |
 
 ### Subagents
 
-Focused specialists. Invoked with `@mention`. Use a fast/cheap model.
+Focused specialists launched **automatically** as parallel quality gates. Each auto-loads its core domain skill for deeper analysis. Use a fast/cheap model.
+
+| Agent | Role | Auto-Loads Skill | Triggered By |
+|-------|------|-----------------|-------------|
+| **@testing** | Writes tests, runs suite, reports coverage | `testing-strategies` | Build (always), Debug (always) |
+| **@security** | OWASP audit, secrets scan, code-level fix patches | `security-hardening` | Build (always), Debug (if security-relevant) |
+| **@fullstack** | Cross-layer implementation + feasibility analysis | Per-layer skills | Build (multi-layer features), Plan (analysis) |
+| **@devops** | CI/CD validation, IaC review, deployment strategy | `deployment-automation` | Build (when CI/Docker/infra files change) |
+
+Subagents return **structured reports** with severity levels (`BLOCKING`, `CRITICAL`, `HIGH`, `MEDIUM`, `LOW`) that the orchestrating agent uses to decide whether to proceed or fix issues first.
+
+### Skill Routing
+
+All agents detect the project's technology stack and **automatically load relevant skills** before working. This turns the 14 domain skills from passive knowledge into active intelligence:
 
-| Agent | Role |
-|-------|------|
-| **@fullstack** | End-to-end feature implementation across frontend + backend |
-| **@testing** | Test writing, coverage analysis, TDD workflow |
-| **@security** | Vulnerability scanning, secure coding review |
-| **@devops** | CI/CD pipelines, Docker, deployment automation |
+```
+Build Agent detects: package.json has React + Express + Prisma
+  → auto-loads: frontend-development, backend-development, database-design, api-design
+  → implements with deep framework-specific knowledge
+```
 
 <br>
 
 ## Tools
 
-22 tools bundled and auto-registered. No configuration needed.
+23 tools bundled and auto-registered. No configuration needed.
 
 <table>
 <tr><td width="50%">
 
 **Git Workflow**
 - `branch_status` - Current branch + change detection
-- `branch_create` - Convention-named branches
+- `branch_create` - Convention-named branches (with toast notifications)
 - `branch_switch` - Safe branch switching
-- `worktree_create` - Isolated worktree in `.worktrees/`
+- `worktree_create` - Isolated worktree in `.worktrees/` (with toast notifications)
 - `worktree_launch` - Launch worktree (terminal/PTY/background)
 - `worktree_list` / `worktree_remove` / `worktree_open`
 
@@ -151,7 +166,7 @@ Focused specialists. Invoked with `@mention`. Use a fast/cheap model.
 **Planning & Sessions**
 - `plan_save` / `plan_load` / `plan_list` / `plan_delete`
 - `session_save` / `session_list` / `session_load`
-- `cortex_init` / `cortex_status`
+- `cortex_init` / `cortex_status` / `cortex_configure`
 
 </td></tr>
 <tr><td width="50%">
@@ -164,11 +179,12 @@ Focused specialists. Invoked with `@mention`. Use a fast/cheap model.
 
 </td><td width="50%">
 
-**Finalization**
+**Finalization & Config**
 - `task_finalize` - Stage, commit, push, create PR
   - Auto-detects worktree (targets main)
   - Auto-populates PR from `.cortex/plans/`
   - Warns if docs are missing
+- `cortex_configure` - Set models from within an agent session
 
 </td></tr>
 </table>
@@ -181,7 +197,6 @@ Focused specialists. Invoked with `@mention`. Use a fast/cheap model.
 
 | Skill | Covers |
 |-------|--------|
-| **web-development** | Full-stack patterns, REST/GraphQL, SSR, state management |
 | **frontend-development** | React, Vue, Svelte, CSS architecture, accessibility |
 | **backend-development** | API design, middleware, auth, caching, queue systems |
 | **mobile-development** | React Native, Flutter, native iOS/Android patterns |
@@ -201,10 +216,11 @@ Focused specialists. Invoked with `@mention`. Use a fast/cheap model.
 
 ## Model Configuration
 
-Cortex agents are **model-agnostic**. Pick any provider:
+Cortex agents are **model-agnostic**. Configure globally or per-project:
 
 ```bash
-npx cortex-agents configure
+npx cortex-agents configure            # Global (all projects)
+npx cortex-agents configure --project  # Per-project (saves to .opencode/models.json)
 ```
 
 ```
@@ -223,6 +239,19 @@ npx cortex-agents configure
   Same as primary
 ```
 
+### In-Agent Configuration
+
+Agents can also configure models during a session via the `cortex_configure` tool — no need to leave OpenCode. The agent will prompt you to select models when `.cortex/` is first initialized.
+
+### Per-Project vs Global
+
+| Scope | Where | Use Case |
+|-------|-------|----------|
+| **Global** | `~/.config/opencode/opencode.json` | Default for all projects |
+| **Per-project** | `.opencode/models.json` + `opencode.json` | Different models for different repos |
+
+Per-project config takes priority. Team members get the same model settings when they clone the repo (`.opencode/models.json` is git-tracked).
+
 ### Supported Providers
 
 | Provider | Premium | Standard | Fast |
@@ -246,6 +275,8 @@ your-project/
      config.json              Configuration
      plans/                   Implementation plans (git tracked)
      sessions/                Session summaries (gitignored)
+  .opencode/
+     models.json              Per-project model config (git tracked)
   .worktrees/                  Git worktrees (gitignored)
      feature-auth/            Isolated development copy
      bugfix-login/
@@ -261,11 +292,13 @@ your-project/
 ## CLI Reference
 
 ```bash
-npx cortex-agents install              # Install plugin, agents, and skills
-npx cortex-agents configure            # Interactive model selection
-npx cortex-agents configure --reset    # Reset to OpenCode defaults
-npx cortex-agents uninstall            # Clean removal of everything
-npx cortex-agents status               # Show installation status
+npx cortex-agents install                      # Install plugin, agents, and skills
+npx cortex-agents configure                    # Global model selection
+npx cortex-agents configure --project          # Per-project model selection
+npx cortex-agents configure --reset            # Reset global models
+npx cortex-agents configure --project --reset  # Reset per-project models
+npx cortex-agents uninstall                    # Clean removal of everything
+npx cortex-agents status                       # Show installation and model status
 ```
 
 <br>
@@ -278,20 +311,50 @@ Every time the build agent starts, it follows a structured pre-implementation ch
 
 ```
 Step 1   branch_status           Am I on a protected branch?
-Step 2   cortex_status           Is .cortex initialized?
+Step 2   cortex_status           Is .cortex initialized? Offer model config if new project.
 Step 3   plan_list / plan_load   Is there a plan for this work?
-Step 4   Ask: strategy           Branch or worktree?
-Step 4b  Ask: launch mode        Stay / terminal / PTY / background?
-Step 5   Execute                 Create branch or launch worktree
+Step 4   Ask: strategy           Worktree (recommended) or branch?
+Step 4b  Ask: launch mode        Terminal tab (recommended) / stay / PTY / background?
+Step 5   Execute                 Create worktree/branch, auto-detect terminal
 Step 6   Implement               Write code following the plan
-Step 7   Ask: documentation      Decision doc / feature doc / flow doc?
-Step 8   session_save            Record what was done and why
-Step 9   task_finalize           Commit, push, create PR
-Step 10  Ask: cleanup            Remove worktree? (if applicable)
+Step 7   Quality Gate            Launch @testing + @security in parallel
+Step 8   Ask: documentation      Decision doc / feature doc / flow doc?
+Step 9   session_save            Record what was done and why
+Step 10  task_finalize           Commit, push, create PR
+Step 11  Ask: cleanup            Remove worktree + close terminal tab? (if applicable)
 ```
 
 This isn't just documentation - it's enforced by the agent's instructions. The AI follows this workflow every time.
 
+### Sub-Agent Quality Gates
+
+After implementation (Step 7), the build agent **automatically** launches sub-agents in parallel as quality gates:
+
+```
+Build Agent completes implementation
+   |
+   +-- launches in parallel (single message) --+
+   |                                            |
+   v                                            v
+@testing                                   @security
+  Writes unit tests                          OWASP audit
+  Runs test suite                            Secrets scan
+  Reports coverage                           Severity ratings
+  Returns: PASS/FAIL                         Returns: PASS/FAIL
+   |                                            |
+   +-------- results reviewed by Build ---------+
+   |
+   v
+Quality Gate Summary included in PR body
+```
+
+The debug agent uses the same pattern: `@testing` for regression tests (always) and `@security` when the fix touches sensitive code.
+
+Sub-agents use **structured return contracts** so results are actionable:
+- `BLOCKING` / `CRITICAL` / `HIGH` findings block finalization
+- `MEDIUM` findings are noted in the PR body
+- `LOW` findings are deferred
+
 ### Agent Handover
 
 When agents switch, a toast notification tells you what mode you're in:
@@ -300,9 +363,10 @@ When agents switch, a toast notification tells you what mode you're in:
 Agent: build                 Development mode - ready to implement
 Agent: plan                  Planning mode - read-only analysis
 Agent: debug                 Debug mode - troubleshooting and fixes
+Agent: review                Review mode - code quality assessment
 ```
 
-The Plan agent creates plans with mermaid diagrams and hands off to Build. Build loads the plan and implements it. If something breaks, Debug takes over with full access.
+The Plan agent creates plans with mermaid diagrams and hands off to Build. Build loads the plan, detects the tech stack, loads relevant skills, and implements. If something breaks, Debug takes over with performance debugging tools. Review provides code quality assessment and tech debt analysis on demand.
 
 <br>
 
@@ -346,7 +410,7 @@ cd ~/.config/opencode && npm unlink cortex-agents && npm install
 
 - **New skills** - Domain-specific knowledge packs (e.g., Rust, Go, DevOps for AWS)
 - **New agents** - Specialized agents (e.g., reviewer, migration, docs-writer)
-- **Platform support** - Improve terminal detection for Linux/Windows
+- **Terminal drivers** - Improve detection/support for additional terminal emulators
 - **Tool improvements** - Better PR templates, test runners, linter integration
 - **Bug fixes** - Anything that doesn't work as expected
 

package/dist/cli.js

@@ -4,7 +4,7 @@ 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.2.0";
+const VERSION = "2.3.0";
 const PLUGIN_NAME = "cortex-agents";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -38,6 +38,66 @@ function writeConfig(configPath, config) {
     fs.mkdirSync(path.dirname(configPath), { recursive: true });
     fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
 }
+// ─── Per-Project Model Config (.opencode/models.json) ───────────────────────
+const PROJECT_MODELS_FILE = "models.json";
+function getProjectModelsPath() {
+    return path.join(process.cwd(), ".opencode", PROJECT_MODELS_FILE);
+}
+function hasProjectModelsConfig() {
+    return fs.existsSync(getProjectModelsPath());
+}
+function readProjectModels() {
+    const modelsPath = getProjectModelsPath();
+    if (!fs.existsSync(modelsPath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(modelsPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function writeProjectModels(primary, subagent) {
+    const modelsPath = getProjectModelsPath();
+    const dir = path.dirname(modelsPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const config = {
+        primary: { model: primary },
+        subagent: { model: subagent },
+        agents: {},
+    };
+    for (const name of PRIMARY_AGENTS) {
+        config.agents[name] = { model: primary };
+    }
+    for (const name of SUBAGENTS) {
+        config.agents[name] = { model: subagent };
+    }
+    fs.writeFileSync(modelsPath, JSON.stringify(config, null, 2) + "\n");
+}
+/**
+ * Sync .opencode/models.json → local opencode.json agent model settings.
+ * Creates or merges into local opencode.json at project root.
+ */
+function syncProjectModelsToConfig() {
+    const models = readProjectModels();
+    if (!models)
+        return false;
+    const localPath = path.join(process.cwd(), "opencode.json");
+    const config = fs.existsSync(localPath)
+        ? readConfig(localPath)
+        : { $schema: "https://opencode.ai/config.json" };
+    if (!config.agent)
+        config.agent = {};
+    for (const [name, entry] of Object.entries(models.agents)) {
+        if (!config.agent[name])
+            config.agent[name] = {};
+        config.agent[name].model = entry.model;
+    }
+    writeConfig(localPath, config);
+    return true;
+}
 // ─── File Copy Helpers ───────────────────────────────────────────────────────
 function copyDirRecursive(src, dest) {
     fs.mkdirSync(dest, { recursive: true });
@@ -137,8 +197,16 @@ function install() {
     // Copy agents and skills into the global opencode config dir
     console.log("Installing agents and skills...");
     installAgentsAndSkills(globalDir);
+    // Sync per-project models if .opencode/models.json exists
+    if (hasProjectModelsConfig()) {
+        console.log("\nPer-project model config found (.opencode/models.json)");
+        if (syncProjectModelsToConfig()) {
+            console.log("  Synced model settings to local opencode.json");
+        }
+    }
     console.log("\nDone! Next steps:");
-    console.log(`  1. Run 'npx ${PLUGIN_NAME} configure' to select your models`);
+    console.log(`  1. Run 'npx ${PLUGIN_NAME} configure' to select your models (global)`);
+    console.log(`     Or 'npx ${PLUGIN_NAME} configure --project' for per-project config`);
     console.log("  2. Restart OpenCode to load the plugin\n");
 }
 function uninstall() {
@@ -180,30 +248,89 @@ function uninstall() {
 async function configure() {
     const args = process.argv.slice(3);
     const isReset = args.includes("--reset");
+    const isProject = args.includes("--project");
     // Handle --reset flag
     if (isReset) {
-        return configureReset();
+        return configureReset(isProject);
+    }
+    const scope = isProject ? "Per-Project" : "Global";
+    console.log(`\n🔧 Cortex Agents — ${scope} Model Configuration\n`);
+    if (isProject) {
+        const opencodeDir = path.join(process.cwd(), ".opencode");
+        if (!fs.existsSync(opencodeDir)) {
+            console.log(`⚠  No .opencode/ directory found in ${process.cwd()}.`);
+            console.log(`   Run 'npx ${PLUGIN_NAME} install' first, or use 'configure' without --project for global config.\n`);
+            process.exit(1);
+        }
+        console.log(`Project: ${process.cwd()}`);
+        console.log(`Config:  .opencode/models.json + opencode.json\n`);
     }
-    console.log(`\n🔧 Cortex Agents — Model Configuration\n`);
-    // Ensure plugin is installed first
+    // Ensure plugin is installed first (for global mode)
     const configInfo = findOpencodeConfig();
     const config = configInfo
         ? readConfig(configInfo.path)
         : { $schema: "https://opencode.ai/config.json" };
-    if (!config.plugin?.includes(PLUGIN_NAME)) {
+    if (!isProject && !config.plugin?.includes(PLUGIN_NAME)) {
         console.log(`⚠  Plugin not installed. Adding '${PLUGIN_NAME}' to config first.\n`);
         if (!config.plugin)
             config.plugin = [];
         config.plugin.push(PLUGIN_NAME);
     }
     // ── Primary model selection ────────────────────────────────
+    const { primary, subagent } = await promptModelSelection();
+    // ── Write config ───────────────────────────────────────────
+    if (isProject) {
+        // Per-project: write .opencode/models.json + sync to local opencode.json
+        writeProjectModels(primary, subagent);
+        syncProjectModelsToConfig();
+        const modelsPath = getProjectModelsPath();
+        const localConfigPath = path.join(process.cwd(), "opencode.json");
+        console.log("━".repeat(50));
+        console.log(`✓ Per-project config saved:\n`);
+        console.log(`  Models:  ${modelsPath}`);
+        console.log(`  Runtime: ${localConfigPath}\n`);
+    }
+    else {
+        // Global: write to opencode.json (existing behavior)
+        if (!config.agent)
+            config.agent = {};
+        for (const name of PRIMARY_AGENTS) {
+            if (!config.agent[name])
+                config.agent[name] = {};
+            config.agent[name].model = primary;
+        }
+        for (const name of SUBAGENTS) {
+            if (!config.agent[name])
+                config.agent[name] = {};
+            config.agent[name].model = subagent;
+        }
+        const targetPath = configInfo?.path || path.join(getGlobalDir(), "opencode.json");
+        writeConfig(targetPath, config);
+        console.log("━".repeat(50));
+        console.log(`✓ Configuration saved to ${targetPath}\n`);
+    }
+    console.log("  Primary agents:");
+    for (const name of PRIMARY_AGENTS) {
+        console.log(`    ${name.padEnd(10)} → ${primary}`);
+    }
+    console.log("\n  Subagents:");
+    for (const name of SUBAGENTS) {
+        console.log(`    ${name.padEnd(10)} → ${subagent}`);
+    }
+    console.log("\nRestart OpenCode to apply changes.\n");
+}
+/**
+ * Interactive prompt for primary + subagent model selection.
+ * Shared between global and per-project configure flows.
+ */
+async function promptModelSelection() {
     const primaryChoices = getPrimaryChoices();
     primaryChoices.push({
         title: "Enter custom model ID",
         description: "provider/model format",
         value: "__custom__",
     });
-    console.log("Primary agents (build, plan, debug) handle complex tasks.\nUse your best available model.\n");
+    console.log("Primary agents (build, plan, debug, review) handle complex tasks.\nUse your best available model.\n");
     const { primaryModel } = await prompts({
         type: "select",
         name: "primaryModel",
@@ -211,7 +338,6 @@ async function configure() {
         choices: primaryChoices,
         hint: "Use arrow keys, Enter to confirm",
     });
-    // User cancelled (Ctrl+C)
     if (primaryModel === undefined) {
         console.log("\nConfiguration cancelled.\n");
         process.exit(0);
@@ -265,36 +391,54 @@ async function configure() {
         subagent = custom;
     }
     console.log(`✓ Subagent model: ${subagent}\n`);
-    // ── Write to opencode.json ─────────────────────────────────
-    if (!config.agent)
-        config.agent = {};
-    for (const name of PRIMARY_AGENTS) {
-        if (!config.agent[name])
-            config.agent[name] = {};
-        config.agent[name].model = primary;
-    }
-    for (const name of SUBAGENTS) {
-        if (!config.agent[name])
-            config.agent[name] = {};
-        config.agent[name].model = subagent;
-    }
-    const targetPath = configInfo?.path || path.join(getGlobalDir(), "opencode.json");
-    writeConfig(targetPath, config);
-    // ── Print summary ──────────────────────────────────────────
-    console.log("━".repeat(50));
-    console.log(`✓ Configuration saved to ${targetPath}\n`);
-    console.log("  Primary agents:");
-    for (const name of PRIMARY_AGENTS) {
-        console.log(`    ${name.padEnd(10)} → ${primary}`);
-    }
-    console.log("\n  Subagents:");
-    for (const name of SUBAGENTS) {
-        console.log(`    ${name.padEnd(10)} → ${subagent}`);
-    }
-    console.log("\nRestart OpenCode to apply changes.\n");
+    return { primary, subagent };
 }
-function configureReset() {
-    console.log(`\n🔧 Cortex Agents — Reset Model Configuration\n`);
+function configureReset(isProject = false) {
+    const scope = isProject ? "Per-Project" : "Global";
+    console.log(`\n🔧 Cortex Agents — Reset ${scope} Model Configuration\n`);
+    if (isProject) {
+        // Reset per-project config
+        const modelsPath = getProjectModelsPath();
+        let removedModels = false;
+        if (fs.existsSync(modelsPath)) {
+            fs.unlinkSync(modelsPath);
+            console.log(`✓ Removed ${modelsPath}`);
+            removedModels = true;
+        }
+        // Also clean agent models from local opencode.json
+        const localConfigPath = path.join(process.cwd(), "opencode.json");
+        if (fs.existsSync(localConfigPath)) {
+            const config = readConfig(localConfigPath);
+            if (config.agent) {
+                let resetCount = 0;
+                for (const name of ALL_AGENTS) {
+                    if (config.agent[name]?.model) {
+                        delete config.agent[name].model;
+                        resetCount++;
+                        if (Object.keys(config.agent[name]).length === 0) {
+                            delete config.agent[name];
+                        }
+                    }
+                }
+                if (Object.keys(config.agent).length === 0) {
+                    delete config.agent;
+                }
+                if (resetCount > 0) {
+                    writeConfig(localConfigPath, config);
+                    console.log(`✓ Removed ${resetCount} agent model entries from ${localConfigPath}`);
+                    removedModels = true;
+                }
+            }
+        }
+        if (!removedModels) {
+            console.log("No per-project model configuration found. Nothing to reset.\n");
+            return;
+        }
+        console.log("\nAgents will now fall back to global or OpenCode default models.");
+        console.log("Restart OpenCode to apply changes.\n");
+        return;
+    }
+    // Global reset (existing behavior)
     const configInfo = findOpencodeConfig();
     if (!configInfo) {
         console.log("No OpenCode config found. Nothing to reset.\n");
@@ -355,12 +499,20 @@ function status() {
         : 0;
     console.log(`\nAgents installed: ${agentCount}`);
     console.log(`Skills installed: ${skillCount}`);
-    // Show model configuration
+    // Show per-project model configuration
+    const projectModels = readProjectModels();
+    if (projectModels) {
+        console.log("\nPer-Project Models (.opencode/models.json):");
+        console.log(`  Primary agents:  ${projectModels.primary.model}`);
+        console.log(`  Subagents:       ${projectModels.subagent.model}`);
+    }
+    // Show global/active model configuration
     if (config.agent) {
         const primaryModels = PRIMARY_AGENTS.map((n) => config.agent?.[n]?.model).filter(Boolean);
         const subagentModels = SUBAGENTS.map((n) => config.agent?.[n]?.model).filter(Boolean);
         if (primaryModels.length > 0 || subagentModels.length > 0) {
-            console.log("\nModel Configuration:");
+            const source = projectModels ? "Active" : "Global";
+            console.log(`\n${source} Model Configuration (opencode.json):`);
             if (primaryModels.length > 0) {
                 const unique = [...new Set(primaryModels)];
                 console.log(`  Primary agents:  ${unique.join(", ")}`);
@@ -370,14 +522,16 @@ function status() {
                 console.log(`  Subagents:       ${unique.join(", ")}`);
             }
         }
-        else {
+        else if (!projectModels) {
             console.log("\nModels: Not configured (using OpenCode defaults)");
-            console.log(`  Run 'npx ${PLUGIN_NAME} configure' to select models.`);
+            console.log(`  Run 'npx ${PLUGIN_NAME} configure' for global config`);
+            console.log(`  Run 'npx ${PLUGIN_NAME} configure --project' for per-project config`);
         }
     }
-    else {
+    else if (!projectModels) {
         console.log("\nModels: Not configured (using OpenCode defaults)");
-        console.log(`  Run 'npx ${PLUGIN_NAME} configure' to select models.`);
+        console.log(`  Run 'npx ${PLUGIN_NAME} configure' for global config`);
+        console.log(`  Run 'npx ${PLUGIN_NAME} configure --project' for per-project config`);
     }
     if (!isInstalled) {
         console.log(`\nRun 'npx ${PLUGIN_NAME} install' to add to config.`);
@@ -395,27 +549,32 @@ USAGE:
 
 COMMANDS:
   install              Install plugin, agents, and skills into OpenCode config
-  configure            Interactive model selection for all agents
+  configure            Interactive model selection (global)
+  configure --project  Interactive model selection (per-project, saves to .opencode/)
   configure --reset    Reset model configuration to OpenCode defaults
+  configure --project --reset  Reset per-project model configuration
   uninstall            Remove plugin, agents, skills, and model config
   status               Show installation and model configuration status
   help                 Show this help message
 
 EXAMPLES:
-  npx ${PLUGIN_NAME} install           # Install plugin
-  npx ${PLUGIN_NAME} configure         # Select models interactively
-  npx ${PLUGIN_NAME} configure --reset # Reset to default models
-  npx ${PLUGIN_NAME} status            # Check status
+  npx ${PLUGIN_NAME} install                    # Install plugin
+  npx ${PLUGIN_NAME} configure                  # Global model selection
+  npx ${PLUGIN_NAME} configure --project        # Per-project models (.opencode/models.json)
+  npx ${PLUGIN_NAME} configure --reset          # Reset global models
+  npx ${PLUGIN_NAME} configure --project --reset # Reset per-project models
+  npx ${PLUGIN_NAME} status                     # Check status
 
 AGENTS:
-  Primary (build, plan, debug):
+  Primary (build, plan, debug, review):
     Handle complex tasks — select your best model.
 
   Subagents (fullstack, testing, security, devops):
     Handle focused tasks — a fast/cheap model works great.
 
-TOOLS (22):
+TOOLS (23):
   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)

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;AAsBlD,eAAO,MAAM,YAAY,EAAE,MAmE1B,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;AAmJlD,eAAO,MAAM,YAAY,EAAE,MAuJ1B,CAAC;AAGF,eAAe,YAAY,CAAC"}