byterover-cli 3.13.0 → 3.15.0

package/oclif.manifest.json

@@ -103,7 +103,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait for task completion",
+          "description": "(deprecated, no effect, kept for compatibility)",
           "name": "timeout",
           "default": 300,
           "hasDynamicHelp": false,
@@ -501,7 +501,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait for task completion",
+          "description": "(deprecated, no effect, kept for compatibility)",
           "name": "timeout",
           "default": 300,
           "hasDynamicHelp": false,
@@ -771,6 +771,144 @@
         "webui.js"
       ]
     },
+    "connectors": {
+      "aliases": [],
+      "args": {},
+      "description": "List installed agent connectors",
+      "examples": [
+        "<%= config.bin %> connectors",
+        "<%= config.bin %> connectors --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "connectors",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "connectors",
+        "index.js"
+      ]
+    },
+    "connectors:install": {
+      "aliases": [],
+      "args": {
+        "agent": {
+          "description": "Agent name to install connector for (e.g., \"Claude Code\", \"Cursor\"). Omit for interactive selection.",
+          "name": "agent",
+          "required": false
+        }
+      },
+      "description": "Install or switch a connector for an agent\n\n  Connector Types:\n    Rules       Agent reads instructions from rule file\n    Hook        Instructions injected on each prompt\n    MCP         Agent connects via MCP protocol\n    Agent Skill Agent reads skill files from project directory\n\n  Available agents     Default         Supported Types\n  ──────────────────── ─────────────── ─────────────────────────\n  Amp                  Agent Skill     Rules, MCP, Agent Skill\n  Antigravity          Agent Skill     Rules, MCP, Agent Skill\n  Auggie CLI           Agent Skill     Rules, MCP, Agent Skill\n  Augment Code         MCP             Rules, MCP\n  Claude Code          Agent Skill     Rules, Hook, MCP, Agent Skill\n  Claude Desktop       MCP             MCP\n  Cline                MCP             Rules, MCP\n  Codex                Agent Skill     Rules, MCP, Agent Skill\n  Cursor               Agent Skill     Rules, MCP, Agent Skill\n  Gemini CLI           Agent Skill     Rules, MCP, Agent Skill\n  Github Copilot       Agent Skill     Rules, MCP, Agent Skill\n  Junie                Agent Skill     Rules, MCP, Agent Skill\n  Kilo Code            Agent Skill     Rules, MCP, Agent Skill\n  Kiro                 Agent Skill     Rules, MCP, Agent Skill\n  OpenClaude           Agent Skill     Rules, MCP, Agent Skill\n  OpenClaw             Agent Skill     Agent Skill\n  OpenCode             Agent Skill     Rules, MCP, Agent Skill\n  Qoder                Agent Skill     Rules, MCP, Agent Skill\n  Qwen Code            MCP             Rules, MCP\n  Roo Code             Agent Skill     Rules, MCP, Agent Skill\n  Trae.ai              Agent Skill     Rules, MCP, Agent Skill\n  Warp                 Agent Skill     Rules, MCP, Agent Skill\n  Windsurf             Agent Skill     Rules, MCP, Agent Skill\n  Zed                  MCP             Rules, MCP",
+      "examples": [
+        "<%= config.bin %> connectors install \"Claude Code\"",
+        "<%= config.bin %> connectors install \"Claude Code\" --type mcp",
+        "<%= config.bin %> connectors install Cursor --type rules"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "type": {
+          "char": "t",
+          "description": "Connector type (rules, hook, mcp, skill). Defaults to agent's recommended type.",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "rules",
+            "hook",
+            "mcp",
+            "skill"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "connectors:install",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "connectors",
+        "install.js"
+      ]
+    },
+    "connectors:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List installed agent connectors",
+      "examples": [
+        "<%= config.bin %> connectors list",
+        "<%= config.bin %> connectors list --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "connectors:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "connectors",
+        "list.js"
+      ]
+    },
     "curate": {
       "aliases": [],
       "args": {
@@ -840,7 +978,7 @@
           "type": "option"
         },
         "timeout": {
-          "description": "Maximum seconds to wait for task completion",
+          "description": "(deprecated, no effect, kept for compatibility)",
           "name": "timeout",
           "default": 300,
           "hasDynamicHelp": false,
@@ -959,31 +1097,14 @@
         "view.js"
       ]
     },
-    "connectors": {
+    "hub": {
       "aliases": [],
       "args": {},
-      "description": "List installed agent connectors",
-      "examples": [
-        "<%= config.bin %> connectors",
-        "<%= config.bin %> connectors --format json"
-      ],
-      "flags": {
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        }
-      },
+      "description": "Browse and manage skills & bundles registry",
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "connectors",
+      "id": "hub",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -994,28 +1115,58 @@
         "dist",
         "oclif",
         "commands",
-        "connectors",
+        "hub",
         "index.js"
       ]
     },
-    "connectors:install": {
+    "hub:install": {
       "aliases": [],
       "args": {
-        "agent": {
-          "description": "Agent name to install connector for (e.g., \"Claude Code\", \"Cursor\"). Omit for interactive selection.",
-          "name": "agent",
-          "required": false
+        "id": {
+          "description": "Entry ID to install",
+          "name": "id",
+          "required": true
         }
       },
-      "description": "Install or switch a connector for an agent\n\n  Connector Types:\n    Rules       Agent reads instructions from rule file\n    Hook        Instructions injected on each prompt\n    MCP         Agent connects via MCP protocol\n    Agent Skill Agent reads skill files from project directory\n\n  Available agents     Default         Supported Types\n  ──────────────────── ─────────────── ─────────────────────────\n  Amp                  Agent Skill     Rules, MCP, Agent Skill\n  Antigravity          Agent Skill     Rules, MCP, Agent Skill\n  Auggie CLI           Agent Skill     Rules, MCP, Agent Skill\n  Augment Code         MCP             Rules, MCP\n  Claude Code          Agent Skill     Rules, Hook, MCP, Agent Skill\n  Claude Desktop       MCP             MCP\n  Cline                MCP             Rules, MCP\n  Codex                Agent Skill     Rules, MCP, Agent Skill\n  Cursor               Agent Skill     Rules, MCP, Agent Skill\n  Gemini CLI           Agent Skill     Rules, MCP, Agent Skill\n  Github Copilot       Agent Skill     Rules, MCP, Agent Skill\n  Junie                Agent Skill     Rules, MCP, Agent Skill\n  Kilo Code            Agent Skill     Rules, MCP, Agent Skill\n  Kiro                 Agent Skill     Rules, MCP, Agent Skill\n  OpenClaude           Agent Skill     Rules, MCP, Agent Skill\n  OpenClaw             Agent Skill     Agent Skill\n  OpenCode             Agent Skill     Rules, MCP, Agent Skill\n  Qoder                Agent Skill     Rules, MCP, Agent Skill\n  Qwen Code            MCP             Rules, MCP\n  Roo Code             Agent Skill     Rules, MCP, Agent Skill\n  Trae.ai              Agent Skill     Rules, MCP, Agent Skill\n  Warp                 Agent Skill     Rules, MCP, Agent Skill\n  Windsurf             Agent Skill     Rules, MCP, Agent Skill\n  Zed                  MCP             Rules, MCP",
+      "description": "Install a skill or bundle from the hub",
       "examples": [
-        "<%= config.bin %> connectors install \"Claude Code\"",
-        "<%= config.bin %> connectors install \"Claude Code\" --type mcp",
-        "<%= config.bin %> connectors install Cursor --type rules"
+        "<%= config.bin %> hub install byterover-review --agent \"Claude Code\"",
+        "<%= config.bin %> hub install typescript-kickstart",
+        "<%= config.bin %> hub install byterover-review --registry myco"
       ],
       "flags": {
+        "agent": {
+          "char": "a",
+          "description": "Target agent for skill install",
+          "name": "agent",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Amp",
+            "Antigravity",
+            "Auggie CLI",
+            "Claude Code",
+            "Codex",
+            "Cursor",
+            "Gemini CLI",
+            "Github Copilot",
+            "Junie",
+            "Kilo Code",
+            "Kiro",
+            "OpenClaude",
+            "OpenClaw",
+            "OpenCode",
+            "Qoder",
+            "Roo Code",
+            "Trae.ai",
+            "Warp",
+            "Windsurf"
+          ],
+          "type": "option"
+        },
         "format": {
-          "description": "Output format (text or json)",
+          "char": "f",
+          "description": "Output format",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1026,24 +1177,31 @@
           ],
           "type": "option"
         },
-        "type": {
-          "char": "t",
-          "description": "Connector type (rules, hook, mcp, skill). Defaults to agent's recommended type.",
-          "name": "type",
+        "registry": {
+          "char": "r",
+          "description": "Registry to install from (when ID exists in multiple registries)",
+          "name": "registry",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "char": "s",
+          "description": "Install scope for skills (global: home directory, project: current project)",
+          "name": "scope",
+          "default": "project",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "rules",
-            "hook",
-            "mcp",
-            "skill"
+            "global",
+            "project"
           ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "connectors:install",
+      "id": "hub:install",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1054,21 +1212,22 @@
         "dist",
         "oclif",
         "commands",
-        "connectors",
+        "hub",
         "install.js"
       ]
     },
-    "connectors:list": {
+    "hub:list": {
       "aliases": [],
       "args": {},
-      "description": "List installed agent connectors",
+      "description": "List available skills & bundles from the hub",
       "examples": [
-        "<%= config.bin %> connectors list",
-        "<%= config.bin %> connectors list --format json"
+        "<%= config.bin %> hub list",
+        "<%= config.bin %> hub list --format json"
       ],
       "flags": {
         "format": {
-          "description": "Output format (text or json)",
+          "char": "f",
+          "description": "Output format",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1082,7 +1241,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "connectors:list",
+      "id": "hub:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1093,18 +1252,91 @@
         "dist",
         "oclif",
         "commands",
-        "connectors",
+        "hub",
         "list.js"
       ]
     },
-    "hub": {
+    "providers:connect": {
       "aliases": [],
-      "args": {},
-      "description": "Browse and manage skills & bundles registry",
-      "flags": {},
+      "args": {
+        "provider": {
+          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter). Omit for interactive selection.",
+          "name": "provider",
+          "required": false
+        }
+      },
+      "description": "Connect or switch to an LLM provider",
+      "examples": [
+        "<%= config.bin %> providers connect",
+        "<%= config.bin %> providers connect anthropic --api-key sk-xxx",
+        "<%= config.bin %> providers connect openai --oauth",
+        "<%= config.bin %> providers connect byterover",
+        "<%= config.bin %> providers connect byterover --team acme",
+        "<%= config.bin %> providers connect openai-compatible --base-url http://localhost:11434/v1 --api-key sk-xxx"
+      ],
+      "flags": {
+        "api-key": {
+          "char": "k",
+          "description": "API key for the provider",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "char": "b",
+          "description": "Base URL for OpenAI-compatible providers (e.g., http://localhost:11434/v1)",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "code": {
+          "char": "c",
+          "description": "Authorization code for code-paste OAuth providers (e.g., Anthropic). Not applicable to browser-callback providers like OpenAI — use --oauth without --code instead.",
+          "hidden": true,
+          "name": "code",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "model": {
+          "char": "m",
+          "description": "Model to set as active after connecting",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "oauth": {
+          "description": "Connect via OAuth (browser-based)",
+          "name": "oauth",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "team": {
+          "description": "Pin this project to a billing team (byterover only). Accepts team name or slug.",
+          "name": "team",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hub",
+      "id": "providers:connect",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1115,58 +1347,27 @@
         "dist",
         "oclif",
         "commands",
-        "hub",
-        "index.js"
+        "providers",
+        "connect.js"
       ]
     },
-    "hub:install": {
+    "providers:disconnect": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Entry ID to install",
-          "name": "id",
+        "provider": {
+          "description": "Provider ID to disconnect",
+          "name": "provider",
           "required": true
         }
       },
-      "description": "Install a skill or bundle from the hub",
+      "description": "Disconnect an LLM provider",
       "examples": [
-        "<%= config.bin %> hub install byterover-review --agent \"Claude Code\"",
-        "<%= config.bin %> hub install typescript-kickstart",
-        "<%= config.bin %> hub install byterover-review --registry myco"
+        "<%= config.bin %> providers disconnect anthropic",
+        "<%= config.bin %> providers disconnect openai --format json"
       ],
       "flags": {
-        "agent": {
-          "char": "a",
-          "description": "Target agent for skill install",
-          "name": "agent",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "Amp",
-            "Antigravity",
-            "Auggie CLI",
-            "Claude Code",
-            "Codex",
-            "Cursor",
-            "Gemini CLI",
-            "Github Copilot",
-            "Junie",
-            "Kilo Code",
-            "Kiro",
-            "OpenClaude",
-            "OpenClaw",
-            "OpenCode",
-            "Qoder",
-            "Roo Code",
-            "Trae.ai",
-            "Warp",
-            "Windsurf"
-          ],
-          "type": "option"
-        },
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1176,32 +1377,11 @@
             "json"
           ],
           "type": "option"
-        },
-        "registry": {
-          "char": "r",
-          "description": "Registry to install from (when ID exists in multiple registries)",
-          "name": "registry",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "scope": {
-          "char": "s",
-          "description": "Install scope for skills (global: home directory, project: current project)",
-          "name": "scope",
-          "default": "project",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "global",
-            "project"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hub:install",
+      "id": "providers:disconnect",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1212,22 +1392,21 @@
         "dist",
         "oclif",
         "commands",
-        "hub",
-        "install.js"
+        "providers",
+        "disconnect.js"
       ]
     },
-    "hub:list": {
+    "providers": {
       "aliases": [],
       "args": {},
-      "description": "List available skills & bundles from the hub",
+      "description": "Show active provider and model",
       "examples": [
-        "<%= config.bin %> hub list",
-        "<%= config.bin %> hub list --format json"
+        "<%= config.bin %> providers",
+        "<%= config.bin %> providers --format json"
       ],
       "flags": {
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1241,7 +1420,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hub:list",
+      "id": "providers",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1252,39 +1431,19 @@
         "dist",
         "oclif",
         "commands",
-        "hub",
-        "list.js"
+        "providers",
+        "index.js"
       ]
     },
-    "review:approve": {
+    "providers:list": {
       "aliases": [],
-      "args": {
-        "taskId": {
-          "description": "Task ID shown in the curate output (e.g. \"brv review approve abc-123\")",
-          "name": "taskId",
-          "required": true
-        }
-      },
-      "description": "Approve pending review operations for a curate task",
+      "args": {},
+      "description": "List all available providers and their connection status",
       "examples": [
-        "# Approve all pending changes from a curate task",
-        "<%= config.bin %> review approve abc-123",
-        "",
-        "# Approve specific files",
-        "<%= config.bin %> review approve abc-123 --file architecture/security/audit.md",
-        "<%= config.bin %> review approve abc-123 --file auth/jwt.md --file auth/oauth.md",
-        "",
-        "# Approve and get structured output (useful for coding agents)",
-        "<%= config.bin %> review approve abc-123 --format json"
+        "<%= config.bin %> providers list",
+        "<%= config.bin %> providers list --format json"
       ],
       "flags": {
-        "file": {
-          "description": "Approve only the specified file path(s) (relative to context tree)",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
         "format": {
           "description": "Output format (text or json)",
           "name": "format",
@@ -1300,7 +1459,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:approve",
+      "id": "providers:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1311,25 +1470,25 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "approve.js"
+        "providers",
+        "list.js"
       ]
     },
-    "review:base-review-decision": {
+    "providers:switch": {
       "aliases": [],
       "args": {
-        "taskId": {
-          "name": "taskId",
+        "provider": {
+          "description": "Provider ID to switch to (e.g., anthropic, openai)",
+          "name": "provider",
           "required": true
         }
       },
+      "description": "Switch the active provider",
+      "examples": [
+        "<%= config.bin %> providers switch anthropic",
+        "<%= config.bin %> providers switch openai --format json"
+      ],
       "flags": {
-        "file": {
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
         "format": {
           "description": "Output format (text or json)",
           "name": "format",
@@ -1345,7 +1504,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:base-review-decision",
+      "id": "providers:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1356,20 +1515,17 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "base-review-decision.js"
+        "providers",
+        "switch.js"
       ]
     },
-    "review:pending": {
+    "model": {
       "aliases": [],
       "args": {},
-      "description": "List all pending review operations for the current project",
+      "description": "Show the active model",
       "examples": [
-        "# Show all pending reviews",
-        "<%= config.bin %> review pending",
-        "",
-        "# Get structured output for agent-driven workflows",
-        "<%= config.bin %> review pending --format json"
+        "<%= config.bin %> model",
+        "<%= config.bin %> model --format json"
       ],
       "flags": {
         "format": {
@@ -1387,7 +1543,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:pending",
+      "id": "model",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1398,229 +1554,8 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "pending.js"
-      ]
-    },
-    "review:reject": {
-      "aliases": [],
-      "args": {
-        "taskId": {
-          "description": "Task ID shown in the curate output (e.g. \"brv review reject abc-123\")",
-          "name": "taskId",
-          "required": true
-        }
-      },
-      "description": "Reject pending review operations for a curate task (restores files from backup)",
-      "examples": [
-        "# Reject all pending changes from a curate task",
-        "<%= config.bin %> review reject abc-123",
-        "",
-        "# Reject specific files",
-        "<%= config.bin %> review reject abc-123 --file architecture/security/audit.md",
-        "<%= config.bin %> review reject abc-123 --file auth/jwt.md --file auth/oauth.md",
-        "",
-        "# Reject and get structured output (useful for coding agents)",
-        "<%= config.bin %> review reject abc-123 --format json"
-      ],
-      "flags": {
-        "file": {
-          "description": "Reject only the specified file path(s) (relative to context tree)",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "review:reject",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "review",
-        "reject.js"
-      ]
-    },
-    "source:add": {
-      "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to the target project containing .brv/",
-          "name": "path",
-          "required": true
-        }
-      },
-      "description": "Add a read-only knowledge source from another project's context tree",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> /path/to/shared-lib",
-        "<%= config.bin %> <%= command.id %> /path/to/shared-lib --alias shared"
-      ],
-      "flags": {
-        "alias": {
-          "description": "Custom alias for the source (defaults to directory name)",
-          "name": "alias",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "source:add",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "source",
-        "add.js"
-      ]
-    },
-    "source": {
-      "aliases": [],
-      "args": {},
-      "description": "Manage knowledge sources (read-only references to other projects)",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --help"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "source",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "source",
-        "index.js"
-      ]
-    },
-    "source:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List all knowledge sources and their status",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "source:list",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "source",
-        "list.js"
-      ]
-    },
-    "source:remove": {
-      "aliases": [],
-      "args": {
-        "aliasOrPath": {
-          "description": "Alias or path of the knowledge source to remove",
-          "name": "aliasOrPath",
-          "required": true
-        }
-      },
-      "description": "Remove a knowledge source",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> shared-lib",
-        "<%= config.bin %> <%= command.id %> /path/to/shared-lib"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "source:remove",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "source",
-        "remove.js"
-      ]
-    },
-    "model": {
-      "aliases": [],
-      "args": {},
-      "description": "Show the active model",
-      "examples": [
-        "<%= config.bin %> model",
-        "<%= config.bin %> model --format json"
-      ],
-      "flags": {
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "model",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "model",
-        "index.js"
+        "model",
+        "index.js"
       ]
     },
     "model:list": {
@@ -1899,48 +1834,78 @@
         "view.js"
       ]
     },
-    "providers:connect": {
+    "review:approve": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter). Omit for interactive selection.",
-          "name": "provider",
-          "required": false
+        "taskId": {
+          "description": "Task ID shown in the curate output (e.g. \"brv review approve abc-123\")",
+          "name": "taskId",
+          "required": true
         }
       },
-      "description": "Connect or switch to an LLM provider",
+      "description": "Approve pending review operations for a curate task",
       "examples": [
-        "<%= config.bin %> providers connect",
-        "<%= config.bin %> providers connect anthropic --api-key sk-xxx",
-        "<%= config.bin %> providers connect openai --oauth",
-        "<%= config.bin %> providers connect byterover",
-        "<%= config.bin %> providers connect byterover --team acme",
-        "<%= config.bin %> providers connect openai-compatible --base-url http://localhost:11434/v1 --api-key sk-xxx"
+        "# Approve all pending changes from a curate task",
+        "<%= config.bin %> review approve abc-123",
+        "",
+        "# Approve specific files",
+        "<%= config.bin %> review approve abc-123 --file architecture/security/audit.md",
+        "<%= config.bin %> review approve abc-123 --file auth/jwt.md --file auth/oauth.md",
+        "",
+        "# Approve and get structured output (useful for coding agents)",
+        "<%= config.bin %> review approve abc-123 --format json"
       ],
       "flags": {
-        "api-key": {
-          "char": "k",
-          "description": "API key for the provider",
-          "name": "api-key",
+        "file": {
+          "description": "Approve only the specified file path(s) (relative to context tree)",
+          "name": "file",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "base-url": {
-          "char": "b",
-          "description": "Base URL for OpenAI-compatible providers (e.g., http://localhost:11434/v1)",
-          "name": "base-url",
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
           "type": "option"
-        },
-        "code": {
-          "char": "c",
-          "description": "Authorization code for code-paste OAuth providers (e.g., Anthropic). Not applicable to browser-callback providers like OpenAI — use --oauth without --code instead.",
-          "hidden": true,
-          "name": "code",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "review:approve",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "review",
+        "approve.js"
+      ]
+    },
+    "review:base-review-decision": {
+      "aliases": [],
+      "args": {
+        "taskId": {
+          "name": "taskId",
+          "required": true
+        }
+      },
+      "flags": {
+        "file": {
+          "name": "file",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "format": {
@@ -1954,32 +1919,112 @@
             "json"
           ],
           "type": "option"
-        },
-        "model": {
-          "char": "m",
-          "description": "Model to set as active after connecting",
-          "name": "model",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "review:base-review-decision",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "review",
+        "base-review-decision.js"
+      ]
+    },
+    "review:pending": {
+      "aliases": [],
+      "args": {},
+      "description": "List all pending review operations for the current project",
+      "examples": [
+        "# Show all pending reviews",
+        "<%= config.bin %> review pending",
+        "",
+        "# Get structured output for agent-driven workflows",
+        "<%= config.bin %> review pending --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "review:pending",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "review",
+        "pending.js"
+      ]
+    },
+    "review:reject": {
+      "aliases": [],
+      "args": {
+        "taskId": {
+          "description": "Task ID shown in the curate output (e.g. \"brv review reject abc-123\")",
+          "name": "taskId",
+          "required": true
+        }
+      },
+      "description": "Reject pending review operations for a curate task (restores files from backup)",
+      "examples": [
+        "# Reject all pending changes from a curate task",
+        "<%= config.bin %> review reject abc-123",
+        "",
+        "# Reject specific files",
+        "<%= config.bin %> review reject abc-123 --file architecture/security/audit.md",
+        "<%= config.bin %> review reject abc-123 --file auth/jwt.md --file auth/oauth.md",
+        "",
+        "# Reject and get structured output (useful for coding agents)",
+        "<%= config.bin %> review reject abc-123 --format json"
+      ],
+      "flags": {
+        "file": {
+          "description": "Reject only the specified file path(s) (relative to context tree)",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": true,
           "type": "option"
         },
-        "oauth": {
-          "description": "Connect via OAuth (browser-based)",
-          "name": "oauth",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "team": {
-          "description": "Pin this project to a billing team (byterover only). Accepts team name or slug.",
-          "name": "team",
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:connect",
+      "id": "review:reject",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1990,23 +2035,23 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "connect.js"
+        "review",
+        "reject.js"
       ]
     },
-    "providers:disconnect": {
+    "settings:get": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to disconnect",
-          "name": "provider",
+        "key": {
+          "description": "Settings key to read",
+          "name": "key",
           "required": true
         }
       },
-      "description": "Disconnect an LLM provider",
+      "description": "Read one settings value. Changes apply after `brv restart`.",
       "examples": [
-        "<%= config.bin %> providers disconnect anthropic",
-        "<%= config.bin %> providers disconnect openai --format json"
+        "<%= config.bin %> settings get agentPool.maxSize",
+        "<%= config.bin %> settings get agentPool.maxSize --format json"
       ],
       "flags": {
         "format": {
@@ -2024,7 +2069,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:disconnect",
+      "id": "settings:get",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2035,17 +2080,17 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "disconnect.js"
+        "settings",
+        "get.js"
       ]
     },
-    "providers": {
+    "settings": {
       "aliases": [],
       "args": {},
-      "description": "Show active provider and model",
+      "description": "List user-configurable BRV settings. Changes apply after `brv restart`.",
       "examples": [
-        "<%= config.bin %> providers",
-        "<%= config.bin %> providers --format json"
+        "<%= config.bin %> settings",
+        "<%= config.bin %> settings --format json"
       ],
       "flags": {
         "format": {
@@ -2063,7 +2108,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers",
+      "id": "settings",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2074,17 +2119,17 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
+        "settings",
         "index.js"
       ]
     },
-    "providers:list": {
+    "settings:list": {
       "aliases": [],
       "args": {},
-      "description": "List all available providers and their connection status",
+      "description": "List user-configurable BRV settings. Changes apply after `brv restart`.",
       "examples": [
-        "<%= config.bin %> providers list",
-        "<%= config.bin %> providers list --format json"
+        "<%= config.bin %> settings list",
+        "<%= config.bin %> settings list --format json"
       ],
       "flags": {
         "format": {
@@ -2102,7 +2147,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:list",
+      "id": "settings:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2113,23 +2158,74 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
+        "settings",
         "list.js"
       ]
     },
-    "providers:switch": {
+    "settings:reset": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to switch to (e.g., anthropic, openai)",
-          "name": "provider",
+        "key": {
+          "description": "Settings key to reset",
+          "name": "key",
           "required": true
         }
       },
-      "description": "Switch the active provider",
+      "description": "Restore one settings value to its default. Changes apply after `brv restart`.",
       "examples": [
-        "<%= config.bin %> providers switch anthropic",
-        "<%= config.bin %> providers switch openai --format json"
+        "<%= config.bin %> settings reset agentPool.maxSize",
+        "<%= config.bin %> settings reset agentPool.maxSize --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "settings:reset",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "settings",
+        "reset.js"
+      ]
+    },
+    "settings:set": {
+      "aliases": [],
+      "args": {
+        "key": {
+          "description": "Settings key to write",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "New value (integer for count keys, duration like 30m / 1h 30m / 1800000 for ms keys)",
+          "name": "value",
+          "required": true
+        }
+      },
+      "description": "Update one settings value. Changes apply after `brv restart`.",
+      "examples": [
+        "<%= config.bin %> settings set agentPool.maxSize 25",
+        "<%= config.bin %> settings set llm.iterationBudgetMs 30m",
+        "<%= config.bin %> settings set agentPool.maxSize 25 --format json"
       ],
       "flags": {
         "format": {
@@ -2147,7 +2243,130 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:switch",
+      "id": "settings:set",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "settings",
+        "set.js"
+      ]
+    },
+    "source:add": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to the target project containing .brv/",
+          "name": "path",
+          "required": true
+        }
+      },
+      "description": "Add a read-only knowledge source from another project's context tree",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> /path/to/shared-lib",
+        "<%= config.bin %> <%= command.id %> /path/to/shared-lib --alias shared"
+      ],
+      "flags": {
+        "alias": {
+          "description": "Custom alias for the source (defaults to directory name)",
+          "name": "alias",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "source:add",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "source",
+        "add.js"
+      ]
+    },
+    "source": {
+      "aliases": [],
+      "args": {},
+      "description": "Manage knowledge sources (read-only references to other projects)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --help"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "source",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "source",
+        "index.js"
+      ]
+    },
+    "source:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all knowledge sources and their status",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "source:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "source",
+        "list.js"
+      ]
+    },
+    "source:remove": {
+      "aliases": [],
+      "args": {
+        "aliasOrPath": {
+          "description": "Alias or path of the knowledge source to remove",
+          "name": "aliasOrPath",
+          "required": true
+        }
+      },
+      "description": "Remove a knowledge source",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> shared-lib",
+        "<%= config.bin %> <%= command.id %> /path/to/shared-lib"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "source:remove",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2158,8 +2377,8 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "switch.js"
+        "source",
+        "remove.js"
       ]
     },
     "space:list": {
@@ -2240,128 +2459,6 @@
         "switch.js"
       ]
     },
-    "worktree:add": {
-      "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to the directory to register as a worktree (relative or absolute)",
-          "name": "path",
-          "required": false
-        }
-      },
-      "description": "Register a directory as a worktree of this project",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> packages/api",
-        "<%= config.bin %> <%= command.id %> ../other-checkout",
-        "<%= config.bin %> <%= command.id %>  (auto-detect parent from subdirectory)"
-      ],
-      "flags": {
-        "force": {
-          "description": "Replace existing .brv/ directory in target with a worktree pointer",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "worktree:add",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "worktree",
-        "add.js"
-      ]
-    },
-    "worktree": {
-      "aliases": [],
-      "args": {},
-      "description": "Manage worktree links for subdirectories and sibling checkouts",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --help"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "worktree",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "worktree",
-        "index.js"
-      ]
-    },
-    "worktree:list": {
-      "aliases": [],
-      "args": {},
-      "description": "Show the current worktree link and list all registered worktrees",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "worktree:list",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "worktree",
-        "list.js"
-      ]
-    },
-    "worktree:remove": {
-      "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to the worktree to remove (defaults to cwd)",
-          "name": "path",
-          "required": false
-        }
-      },
-      "description": "Remove a worktree registration and its .brv pointer",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>  (remove cwd as worktree)",
-        "<%= config.bin %> <%= command.id %> packages/api  (remove from parent)"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "worktree:remove",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "worktree",
-        "remove.js"
-      ]
-    },
     "swarm:curate": {
       "aliases": [],
       "args": {
@@ -2542,6 +2639,128 @@
         "status.js"
       ]
     },
+    "worktree:add": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to the directory to register as a worktree (relative or absolute)",
+          "name": "path",
+          "required": false
+        }
+      },
+      "description": "Register a directory as a worktree of this project",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> packages/api",
+        "<%= config.bin %> <%= command.id %> ../other-checkout",
+        "<%= config.bin %> <%= command.id %>  (auto-detect parent from subdirectory)"
+      ],
+      "flags": {
+        "force": {
+          "description": "Replace existing .brv/ directory in target with a worktree pointer",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree:add",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "worktree",
+        "add.js"
+      ]
+    },
+    "worktree": {
+      "aliases": [],
+      "args": {},
+      "description": "Manage worktree links for subdirectories and sibling checkouts",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --help"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "worktree",
+        "index.js"
+      ]
+    },
+    "worktree:list": {
+      "aliases": [],
+      "args": {},
+      "description": "Show the current worktree link and list all registered worktrees",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "worktree",
+        "list.js"
+      ]
+    },
+    "worktree:remove": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to the worktree to remove (defaults to cwd)",
+          "name": "path",
+          "required": false
+        }
+      },
+      "description": "Remove a worktree registration and its .brv pointer",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>  (remove cwd as worktree)",
+        "<%= config.bin %> <%= command.id %> packages/api  (remove from parent)"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree:remove",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "worktree",
+        "remove.js"
+      ]
+    },
     "vc:add": {
       "aliases": [],
       "args": {},
@@ -3516,5 +3735,5 @@
       ]
     }
   },
-  "version": "3.13.0"
+  "version": "3.15.0"
 }