byterover-cli 3.4.0 → 3.5.0

package/dist/oclif/commands/connectors/install.d.ts

@@ -15,13 +15,13 @@ export default class ConnectorsInstall extends Command {
         agentId: string;
         connectorType?: string;
     }, options?: DaemonClientOptions): Promise<{
-        agentId: "Amp" | "Antigravity" | "Auggie CLI" | "Augment Code" | "Claude Code" | "Cline" | "Codex" | "Cursor" | "Gemini CLI" | "Github Copilot" | "Junie" | "Kilo Code" | "Kiro" | "OpenClaw" | "OpenCode" | "Qoder" | "Qwen Code" | "Roo Code" | "Trae.ai" | "Warp" | "Windsurf" | "Zed";
+        agentId: "Amp" | "Antigravity" | "Auggie CLI" | "Augment Code" | "Claude Code" | "Claude Desktop" | "Cline" | "Codex" | "Cursor" | "Gemini CLI" | "Github Copilot" | "Junie" | "Kilo Code" | "Kiro" | "OpenClaw" | "OpenCode" | "Qoder" | "Qwen Code" | "Roo Code" | "Trae.ai" | "Warp" | "Windsurf" | "Zed";
         alreadySameType: boolean;
         connectorType: "rules" | "hook" | "mcp" | "skill";
         fromType?: undefined;
         result?: undefined;
     } | {
-        agentId: "Amp" | "Antigravity" | "Auggie CLI" | "Augment Code" | "Claude Code" | "Cline" | "Codex" | "Cursor" | "Gemini CLI" | "Github Copilot" | "Junie" | "Kilo Code" | "Kiro" | "OpenClaw" | "OpenCode" | "Qoder" | "Qwen Code" | "Roo Code" | "Trae.ai" | "Warp" | "Windsurf" | "Zed";
+        agentId: "Amp" | "Antigravity" | "Auggie CLI" | "Augment Code" | "Claude Code" | "Claude Desktop" | "Cline" | "Codex" | "Cursor" | "Gemini CLI" | "Github Copilot" | "Junie" | "Kilo Code" | "Kiro" | "OpenClaw" | "OpenCode" | "Qoder" | "Qwen Code" | "Roo Code" | "Trae.ai" | "Warp" | "Windsurf" | "Zed";
         alreadySameType: boolean;
         connectorType: "rules" | "hook" | "mcp" | "skill";
         fromType: "rules" | "hook" | "mcp" | "skill" | undefined;

package/dist/oclif/commands/connectors/install.js

@@ -2,7 +2,7 @@ import { select } from '@inquirer/prompts';
 import { Args, Command, Flags } from '@oclif/core';
 import { AGENT_CONNECTOR_CONFIG } from '../../../server/core/domain/entities/agent.js';
 import { ConnectorEvents, } from '../../../shared/transport/events/connector-events.js';
-import { AGENT_VALUES } from '../../../shared/types/agent.js';
+import { AGENT_VALUES, CLAUDE_DESKTOP } from '../../../shared/types/agent.js';
 import { isConnectorType, requiresAgentRestart } from '../../../shared/types/connector-type.js';
 import { getConnectorName } from '../../../tui/features/connectors/utils/get-connector-name.js';
 import { withDaemonRetry } from '../../lib/daemon-client.js';
@@ -70,7 +70,10 @@ ${agentTable}`;
                 return { agentId: matchedAgent.id, alreadySameType: true, connectorType: resolvedType };
             }
             // 5. Install or switch
-            const result = await client.requestWithAck(ConnectorEvents.INSTALL, { agentId: matchedAgent.id, connectorType: resolvedType });
+            const result = await client.requestWithAck(ConnectorEvents.INSTALL, {
+                agentId: matchedAgent.id,
+                connectorType: resolvedType,
+            });
             if (!result.success) {
                 throw new Error(result.message);
             }
@@ -132,10 +135,12 @@ ${agentTable}`;
                         configPath: installResult.result?.configPath,
                         connectorType: installResult.connectorType,
                         ...(installResult.alreadySameType ? { message: 'Already using this connector type' } : {}),
-                        ...(installResult.result?.requiresManualSetup ? {
-                            manualInstructions: installResult.result.manualInstructions,
-                            requiresManualSetup: true,
-                        } : {}),
+                        ...(installResult.result?.requiresManualSetup
+                            ? {
+                                manualInstructions: installResult.result.manualInstructions,
+                                requiresManualSetup: true,
+                            }
+                            : {}),
                     },
                     success: true,
                 });
@@ -167,7 +172,10 @@ ${agentTable}`;
                 this.log(`Location: ${installResult.result.configPath}`);
             }
             if (requiresAgentRestart(installResult.connectorType)) {
-                this.log(`\nPlease restart ${installResult.agentId} to apply the new ${getConnectorName(installResult.connectorType)}.`);
+                const hint = installResult.agentId === CLAUDE_DESKTOP
+                    ? `\nQuit ${installResult.agentId} from the system tray (Win) or menu bar (Mac), then reopen it.`
+                    : `\nPlease restart ${installResult.agentId} to apply the new ${getConnectorName(installResult.connectorType)}.`;
+                this.log(hint);
             }
         }
         catch (error) {

package/dist/server/core/domain/entities/agent.js

@@ -30,6 +30,10 @@ export const AGENT_CONNECTOR_CONFIG = {
         default: 'skill',
         supported: ['rules', 'hook', 'mcp', 'skill'],
     },
+    'Claude Desktop': {
+        default: 'mcp',
+        supported: ['mcp'],
+    },
     Cline: {
         default: 'mcp',
         supported: ['rules', 'mcp'],

package/dist/server/infra/connectors/mcp/claude-desktop-config-path.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Dependencies for platform detection, injectable for testing.
+ */
+type PlatformDeps = {
+    env: Record<string, string | undefined>;
+    existsSync?: (path: string) => boolean;
+    homedir: () => string;
+    platform: () => NodeJS.Platform;
+};
+/**
+ * Returns the absolute path to the Claude Desktop config file,
+ * following platform conventions:
+ * - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
+ * - Windows: %APPDATA%\Claude\claude_desktop_config.json
+ * - Linux: ~/.config/Claude/claude_desktop_config.json
+ *
+ * @returns Absolute path to the Claude Desktop config file
+ */
+export declare const getClaudeDesktopConfigPath: (deps?: PlatformDeps) => string;
+export {};

package/dist/server/infra/connectors/mcp/claude-desktop-config-path.js

@@ -0,0 +1,47 @@
+import { existsSync } from 'node:fs';
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+const CLAUDE_DESKTOP_CONFIG_FILE = 'claude_desktop_config.json';
+const CLAUDE_DESKTOP_DIR = 'Claude';
+// Publisher hash is derived from Anthropic's signing certificate — stable per publisher identity
+const MSIX_PACKAGE_DIR = 'Claude_pzs8sxrjxfjjc';
+const defaultDeps = {
+    env: process.env,
+    homedir,
+    platform,
+};
+/**
+ * Returns the absolute path to the Claude Desktop config file,
+ * following platform conventions:
+ * - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
+ * - Windows: %APPDATA%\Claude\claude_desktop_config.json
+ * - Linux: ~/.config/Claude/claude_desktop_config.json
+ *
+ * @returns Absolute path to the Claude Desktop config file
+ */
+export const getClaudeDesktopConfigPath = (deps = defaultDeps) => {
+    const currentPlatform = deps.platform();
+    if (currentPlatform === 'win32') {
+        const checkExists = deps.existsSync ?? existsSync;
+        const localAppData = deps.env.LOCALAPPDATA ?? join(deps.homedir(), 'AppData', 'Local');
+        const msixDir = join(localAppData, 'Packages', MSIX_PACKAGE_DIR, 'LocalCache', 'Roaming', CLAUDE_DESKTOP_DIR);
+        // Check directory, not the config file — file may not exist yet on first launch
+        if (checkExists(msixDir))
+            return join(msixDir, CLAUDE_DESKTOP_CONFIG_FILE);
+        const appData = deps.env.APPDATA;
+        if (appData !== undefined) {
+            return join(appData, CLAUDE_DESKTOP_DIR, CLAUDE_DESKTOP_CONFIG_FILE);
+        }
+        return join(deps.homedir(), 'AppData', 'Roaming', CLAUDE_DESKTOP_DIR, CLAUDE_DESKTOP_CONFIG_FILE);
+    }
+    if (currentPlatform === 'darwin') {
+        return join(deps.homedir(), 'Library', 'Application Support', CLAUDE_DESKTOP_DIR, CLAUDE_DESKTOP_CONFIG_FILE);
+    }
+    // Linux and other platforms: respect XDG_CONFIG_HOME if set
+    const xdgConfigHome = deps.env.XDG_CONFIG_HOME;
+    if (xdgConfigHome !== undefined) {
+        return join(xdgConfigHome, CLAUDE_DESKTOP_DIR, CLAUDE_DESKTOP_CONFIG_FILE);
+    }
+    // Default fallback (Linux and other platforms)
+    return join(deps.homedir(), '.config', CLAUDE_DESKTOP_DIR, CLAUDE_DESKTOP_CONFIG_FILE);
+};

package/dist/server/infra/connectors/mcp/mcp-connector-config.d.ts

@@ -19,6 +19,12 @@ export type McpConfigMode = 'auto' | 'manual';
 type McpConnectorConfigBase = {
     /** Path to the MCP config file (relative to project root). Used when scope is 'project'. */
     configPath?: string;
+    /**
+     * Function that returns an absolute path to the config file.
+     * Takes precedence over configPath when present.
+     * Used when the path varies by platform (e.g., Claude Desktop).
+     */
+    configPathResolver?: () => string;
     /** Config file format */
     format: McpConfigFormat;
     /** Guide URL or instructions for manual setup. Required when mode is 'manual'. */
@@ -106,6 +112,19 @@ export declare const MCP_CONNECTOR_CONFIGS: {
         };
         readonly serverKeyPath: readonly ["mcpServers", "brv"];
     };
+    readonly 'Claude Desktop': {
+        readonly configPathResolver: (deps?: {
+            env: Record<string, string | undefined>;
+            existsSync?: (path: string) => boolean;
+            homedir: () => string;
+            platform: () => NodeJS.Platform;
+        }) => string;
+        readonly format: "json";
+        readonly mode: "auto";
+        readonly scope: "global";
+        readonly serverConfig: McpServerConfig;
+        readonly serverKeyPath: readonly ["mcpServers", "brv"];
+    };
     readonly Cline: {
         readonly format: "json";
         readonly manualGuide: "https://docs.cline.bot/mcp/configuring-mcp-servers#editing-mcp-settings-files";

package/dist/server/infra/connectors/mcp/mcp-connector-config.js

@@ -1,3 +1,4 @@
+import { getClaudeDesktopConfigPath } from './claude-desktop-config-path.js';
 /* eslint-disable perfectionist/sort-objects */
 /** Default MCP server configuration */
 const DEFAULT_SERVER_CONFIG = {
@@ -60,6 +61,14 @@ export const MCP_CONNECTOR_CONFIGS = {
         },
         serverKeyPath: STANDARD_KEY_PATH,
     },
+    'Claude Desktop': {
+        configPathResolver: getClaudeDesktopConfigPath,
+        format: 'json',
+        mode: 'auto',
+        scope: 'global',
+        serverConfig: DEFAULT_SERVER_CONFIG,
+        serverKeyPath: STANDARD_KEY_PATH,
+    },
     Cline: {
         format: 'json',
         manualGuide: 'https://docs.cline.bot/mcp/configuring-mcp-servers#editing-mcp-settings-files',

package/dist/server/infra/connectors/mcp/mcp-connector.js

@@ -198,6 +198,9 @@ export class McpConnector {
      * - Global scope: relative to os.homedir()
      */
     getFullConfigPath(config) {
+        if (config.configPathResolver) {
+            return config.configPathResolver();
+        }
         if (!config.configPath) {
             return '';
         }
@@ -265,7 +268,9 @@ export class McpConnector {
      * Install the rule file with MCP-specific content.
      */
     async installRuleFile(agent) {
-        const rulesConfig = agent in RULES_CONNECTOR_CONFIGS ? RULES_CONNECTOR_CONFIGS[agent] : undefined;
+        const rulesConfig = agent in RULES_CONNECTOR_CONFIGS
+            ? RULES_CONNECTOR_CONFIGS[agent]
+            : undefined;
         if (!rulesConfig) {
             return;
         }
@@ -300,7 +305,9 @@ export class McpConnector {
      * Checks for markers AND MCP-specific tool references (brv-query, brv-curate).
      */
     async statusManual(agent) {
-        const rulesConfig = agent in RULES_CONNECTOR_CONFIGS ? RULES_CONNECTOR_CONFIGS[agent] : undefined;
+        const rulesConfig = agent in RULES_CONNECTOR_CONFIGS
+            ? RULES_CONNECTOR_CONFIGS[agent]
+            : undefined;
         if (!rulesConfig) {
             return {
                 configExists: false,
@@ -330,7 +337,9 @@ export class McpConnector {
      * Uninstall the rule file content.
      */
     async uninstallRuleFile(agent) {
-        const rulesConfig = agent in RULES_CONNECTOR_CONFIGS ? RULES_CONNECTOR_CONFIGS[agent] : undefined;
+        const rulesConfig = agent in RULES_CONNECTOR_CONFIGS
+            ? RULES_CONNECTOR_CONFIGS[agent]
+            : undefined;
         if (!rulesConfig) {
             return;
         }

package/dist/shared/types/agent.d.ts

@@ -1,5 +1,6 @@
 /**
  * Array of all supported Agents.
  */
-export declare const AGENT_VALUES: readonly ["Amp", "Antigravity", "Auggie CLI", "Augment Code", "Claude Code", "Cline", "Codex", "Cursor", "Gemini CLI", "Github Copilot", "Junie", "Kilo Code", "Kiro", "OpenClaw", "OpenCode", "Qoder", "Qwen Code", "Roo Code", "Trae.ai", "Warp", "Windsurf", "Zed"];
+export declare const AGENT_VALUES: readonly ["Amp", "Antigravity", "Auggie CLI", "Augment Code", "Claude Code", "Claude Desktop", "Cline", "Codex", "Cursor", "Gemini CLI", "Github Copilot", "Junie", "Kilo Code", "Kiro", "OpenClaw", "OpenCode", "Qoder", "Qwen Code", "Roo Code", "Trae.ai", "Warp", "Windsurf", "Zed"];
 export type Agent = (typeof AGENT_VALUES)[number];
+export declare const CLAUDE_DESKTOP: Agent;

package/dist/shared/types/agent.js

@@ -7,6 +7,7 @@ export const AGENT_VALUES = [
     'Auggie CLI',
     'Augment Code',
     'Claude Code',
+    'Claude Desktop',
     'Cline',
     'Codex',
     'Cursor',
@@ -25,3 +26,4 @@ export const AGENT_VALUES = [
     'Windsurf',
     'Zed',
 ];
+export const CLAUDE_DESKTOP = 'Claude Desktop';

package/dist/tui/features/connectors/components/connectors-flow.js

@@ -12,6 +12,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import chalk from 'chalk';
 import { Box, Text } from 'ink';
 import { useCallback, useMemo, useState } from 'react';
+import { CLAUDE_DESKTOP } from '../../../../shared/types/agent.js';
 import { requiresAgentRestart } from '../../../../shared/types/connector-type.js';
 import { useTheme } from '../../../hooks/index.js';
 import { useGetAgentConfigPaths } from '../api/get-agent-config-paths.js';
@@ -119,9 +120,13 @@ export const ConnectorsFlow = ({ isActive = true, onCancel, onComplete }) => {
                     : `${agentName} connected via ${getConnectorName(connectorType)}`;
                 const locationLine = result.configPath ? `\nLocation: ${result.configPath}` : '';
                 const prompt = chalk.hex('#0AA77D').italic('> "Save our API authentication patterns, use brv curate"');
-                const restartAgentRequired = requiresAgentRestart(connectorType);
+                const restartHint = requiresAgentRestart(connectorType)
+                    ? agentName === CLAUDE_DESKTOP
+                        ? `\n⚠️  Quit ${agentName} from the system tray (Win) or menu bar (Mac), then reopen it.`
+                        : `\n⚠️  Please restart ${agentName} to apply the new ${getConnectorName(connectorType)}.`
+                    : '';
                 const message = `${statusMessage}${locationLine}
-${restartAgentRequired ? `\n⚠️  Please restart ${agentName} to apply the new ${getConnectorName(connectorType)}.` : ''}
+${restartHint}
 
 WHAT'S NEXT
 Try this in your next prompt:

package/oclif.manifest.json

@@ -640,7 +640,7 @@
           "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  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  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 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  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",
@@ -1216,33 +1216,47 @@
         "switch.js"
       ]
     },
-    "review:approve": {
+    "providers:connect": {
       "aliases": [],
       "args": {
-        "taskId": {
-          "description": "Task ID shown in the curate output (e.g. \"brv review approve abc-123\")",
-          "name": "taskId",
-          "required": true
+        "provider": {
+          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter). Omit for interactive selection.",
+          "name": "provider",
+          "required": false
         }
       },
-      "description": "Approve pending review operations for a curate task",
+      "description": "Connect or switch to an LLM provider",
       "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 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 openai-compatible --base-url http://localhost:11434/v1 --api-key sk-xxx"
       ],
       "flags": {
-        "file": {
-          "description": "Approve only the specified file path(s) (relative to context tree)",
-          "name": "file",
+        "api-key": {
+          "char": "k",
+          "description": "API key for the provider",
+          "name": "api-key",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "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": {
@@ -1256,11 +1270,25 @@
             "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:approve",
+      "id": "providers:connect",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1271,25 +1299,25 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "approve.js"
+        "providers",
+        "connect.js"
       ]
     },
-    "review:base-review-decision": {
+    "providers:disconnect": {
       "aliases": [],
       "args": {
-        "taskId": {
-          "name": "taskId",
+        "provider": {
+          "description": "Provider ID to disconnect",
+          "name": "provider",
           "required": true
         }
       },
+      "description": "Disconnect an LLM provider",
+      "examples": [
+        "<%= config.bin %> providers disconnect anthropic",
+        "<%= config.bin %> providers disconnect openai --format json"
+      ],
       "flags": {
-        "file": {
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
         "format": {
           "description": "Output format (text or json)",
           "name": "format",
@@ -1305,7 +1333,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:base-review-decision",
+      "id": "providers:disconnect",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1316,20 +1344,17 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "base-review-decision.js"
+        "providers",
+        "disconnect.js"
       ]
     },
-    "review:pending": {
+    "providers": {
       "aliases": [],
       "args": {},
-      "description": "List all pending review operations for the current project",
+      "description": "Show active provider and 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 %> providers",
+        "<%= config.bin %> providers --format json"
       ],
       "flags": {
         "format": {
@@ -1347,7 +1372,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:pending",
+      "id": "providers",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1358,39 +1383,19 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "pending.js"
+        "providers",
+        "index.js"
       ]
     },
-    "review:reject": {
+    "providers:list": {
       "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)",
+      "args": {},
+      "description": "List all available providers and their connection status",
       "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"
+        "<%= config.bin %> providers list",
+        "<%= config.bin %> providers list --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",
@@ -1406,7 +1411,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:reject",
+      "id": "providers:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1417,53 +1422,25 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "reject.js"
+        "providers",
+        "list.js"
       ]
     },
-    "providers:connect": {
+    "providers:switch": {
       "aliases": [],
       "args": {
         "provider": {
-          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter). Omit for interactive selection.",
+          "description": "Provider ID to switch to (e.g., anthropic, openai)",
           "name": "provider",
-          "required": false
+          "required": true
         }
       },
-      "description": "Connect or switch to an LLM provider",
+      "description": "Switch the active 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 openai-compatible --base-url http://localhost:11434/v1 --api-key sk-xxx"
+        "<%= config.bin %> providers switch anthropic",
+        "<%= config.bin %> providers switch openai --format json"
       ],
       "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",
@@ -1475,25 +1452,11 @@
             "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:connect",
+      "id": "providers:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1505,24 +1468,38 @@
         "oclif",
         "commands",
         "providers",
-        "connect.js"
+        "switch.js"
       ]
     },
-    "providers:disconnect": {
+    "review:approve": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to disconnect",
-          "name": "provider",
+        "taskId": {
+          "description": "Task ID shown in the curate output (e.g. \"brv review approve abc-123\")",
+          "name": "taskId",
           "required": true
         }
       },
-      "description": "Disconnect an LLM provider",
+      "description": "Approve pending review operations for a curate task",
       "examples": [
-        "<%= config.bin %> providers disconnect anthropic",
-        "<%= config.bin %> providers disconnect openai --format json"
+        "# 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": {
+        "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",
@@ -1538,7 +1515,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:disconnect",
+      "id": "review:approve",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1549,19 +1526,25 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "disconnect.js"
+        "review",
+        "approve.js"
       ]
     },
-    "providers": {
+    "review:base-review-decision": {
       "aliases": [],
-      "args": {},
-      "description": "Show active provider and model",
-      "examples": [
-        "<%= config.bin %> providers",
-        "<%= config.bin %> providers --format json"
-      ],
+      "args": {
+        "taskId": {
+          "name": "taskId",
+          "required": true
+        }
+      },
       "flags": {
+        "file": {
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "format": {
           "description": "Output format (text or json)",
           "name": "format",
@@ -1577,7 +1560,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers",
+      "id": "review:base-review-decision",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1588,17 +1571,20 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "index.js"
+        "review",
+        "base-review-decision.js"
       ]
     },
-    "providers:list": {
+    "review:pending": {
       "aliases": [],
       "args": {},
-      "description": "List all available providers and their connection status",
+      "description": "List all pending review operations for the current project",
       "examples": [
-        "<%= config.bin %> providers list",
-        "<%= config.bin %> providers list --format json"
+        "# Show all pending reviews",
+        "<%= config.bin %> review pending",
+        "",
+        "# Get structured output for agent-driven workflows",
+        "<%= config.bin %> review pending --format json"
       ],
       "flags": {
         "format": {
@@ -1616,7 +1602,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:list",
+      "id": "review:pending",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1627,25 +1613,39 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "list.js"
+        "review",
+        "pending.js"
       ]
     },
-    "providers:switch": {
+    "review:reject": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to switch to (e.g., anthropic, openai)",
-          "name": "provider",
+        "taskId": {
+          "description": "Task ID shown in the curate output (e.g. \"brv review reject abc-123\")",
+          "name": "taskId",
           "required": true
         }
       },
-      "description": "Switch the active provider",
+      "description": "Reject pending review operations for a curate task (restores files from backup)",
       "examples": [
-        "<%= config.bin %> providers switch anthropic",
-        "<%= config.bin %> providers switch openai --format json"
+        "# 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",
@@ -1661,7 +1661,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:switch",
+      "id": "review:reject",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1672,8 +1672,8 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "switch.js"
+        "review",
+        "reject.js"
       ]
     },
     "space:list": {
@@ -1877,6 +1877,128 @@
         "remove.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": {
@@ -2659,128 +2781,6 @@
         "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"
-      ]
-    },
     "hub:registry:add": {
       "aliases": [],
       "args": {
@@ -3080,5 +3080,5 @@
       ]
     }
   },
-  "version": "3.4.0"
+  "version": "3.5.0"
 }

package/package.json

@@ -12,7 +12,7 @@
     "coding-assistant",
     "knowledge-management"
   ],
-  "version": "3.4.0",
+  "version": "3.5.0",
   "author": "ByteRover",
   "bin": {
     "brv": "./bin/run.js"