byterover-cli 3.4.0 → 3.5.1

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/server/infra/mcp/mcp-server.js

@@ -39,6 +39,9 @@ export class ByteRoverMcpServer {
         this.server = new McpServer({
             name: 'byterover',
             version: config.version,
+        }, {
+            instructions: 'ByteRover MCP — curate and query project context trees. ' +
+                'See the `cwd` parameter description on each tool for how to provide the project path correctly.',
         });
         this.connectOptions = {
             clientType: 'mcp',

package/dist/server/infra/mcp/tools/brv-curate-tool.js

@@ -2,19 +2,15 @@ import { waitForConnectedClient } from '@campfirein/brv-transport-client';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
 import { TransportTaskEventNames } from '../../../core/domain/transport/schemas.js';
-import { associateProjectWithRetry, resolveMcpTaskContext, } from './mcp-project-context.js';
+import { associateProjectWithRetry, resolveMcpTaskContext } from './mcp-project-context.js';
 import { resolveClientCwd } from './resolve-client-cwd.js';
+import { cwdField } from './shared-schema.js';
 export const BrvCurateInputSchema = z.object({
     context: z
         .string()
         .optional()
         .describe('Knowledge to store: patterns, decisions, errors, or insights about the codebase. Required unless files or folder are provided.'),
-    cwd: z
-        .string()
-        .optional()
-        .describe('Working directory of the project (absolute path). ' +
-        'Required when the MCP server runs in global mode (e.g., Windsurf). ' +
-        'Optional in project mode — defaults to the project directory.'),
+    cwd: cwdField,
     files: z
         .array(z.string())
         .max(5)

package/dist/server/infra/mcp/tools/brv-query-tool.js

@@ -2,16 +2,12 @@ import { waitForConnectedClient } from '@campfirein/brv-transport-client';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
 import { TransportTaskEventNames } from '../../../core/domain/transport/schemas.js';
-import { associateProjectWithRetry, resolveMcpTaskContext, } from './mcp-project-context.js';
+import { associateProjectWithRetry, resolveMcpTaskContext } from './mcp-project-context.js';
 import { resolveClientCwd } from './resolve-client-cwd.js';
+import { cwdField } from './shared-schema.js';
 import { waitForTaskResult } from './task-result-waiter.js';
 export const BrvQueryInputSchema = z.object({
-    cwd: z
-        .string()
-        .optional()
-        .describe('Working directory of the project (absolute path). ' +
-        'Required when the MCP server runs in global mode (e.g., Windsurf). ' +
-        'Optional in project mode — defaults to the project directory.'),
+    cwd: cwdField,
     query: z.string().describe('Natural language question about the codebase or project'),
 });
 /**

package/dist/server/infra/mcp/tools/index.d.ts

@@ -1,4 +1,5 @@
 export { registerBrvCurateTool } from './brv-curate-tool.js';
 export { registerBrvQueryTool } from './brv-query-tool.js';
 export { resolveClientCwd } from './resolve-client-cwd.js';
+export { CWD_DESCRIPTION, cwdField } from './shared-schema.js';
 export { waitForTaskResult } from './task-result-waiter.js';

package/dist/server/infra/mcp/tools/index.js

@@ -1,4 +1,5 @@
 export { registerBrvCurateTool } from './brv-curate-tool.js';
 export { registerBrvQueryTool } from './brv-query-tool.js';
 export { resolveClientCwd } from './resolve-client-cwd.js';
+export { CWD_DESCRIPTION, cwdField } from './shared-schema.js';
 export { waitForTaskResult } from './task-result-waiter.js';

package/dist/server/infra/mcp/tools/shared-schema.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+export declare const CWD_DESCRIPTION: string;
+export declare const cwdField: z.ZodOptional<z.ZodString>;

package/dist/server/infra/mcp/tools/shared-schema.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export const CWD_DESCRIPTION = 'Absolute path to the project root — selects which ByteRover context tree to use ' +
+    String.raw `(e.g., "/Users/me/code/myapp", "C:\\code\\myapp").` +
+    '\n\n' +
+    'When to provide:\n' +
+    '- If your runtime does NOT expose any workspace/project context to you ' +
+    '(e.g., Claude Desktop, hosted MCP, global Windsurf): you MUST provide cwd. ' +
+    'Use the path the user mentions, or ASK the user for the absolute path if unknown.\n' +
+    '- If your runtime DOES expose an open workspace/project root to you ' +
+    '(e.g., Cursor, Cline, Zed, Claude Code): you can OMIT this field — ' +
+    'the MCP server was launched from that same project and already knows the cwd. ' +
+    'Providing it is harmless but unnecessary.\n' +
+    '\n' +
+    'If you omit cwd and the tool returns an error about the project not being resolved or cwd being required, retry with cwd explicitly set to the project root path.\n' +
+    '\n' +
+    'Never guess, never invent paths, never use relative paths.';
+export const cwdField = z.string().optional().describe(CWD_DESCRIPTION);

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,211 +1216,6 @@
         "switch.js"
       ]
     },
-    "review:approve": {
-      "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",
-      "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"
-      ],
-      "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",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        }
-      },
-      "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": 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: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"
-        },
-        "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"
-      ]
-    },
     "providers:connect": {
       "aliases": [],
       "args": {
@@ -1676,17 +1471,37 @@
         "switch.js"
       ]
     },
-    "space:list": {
+    "review:approve": {
       "aliases": [],
-      "args": {},
-      "description": "List all teams and spaces (deprecated)",
+      "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",
       "examples": [
-        "<%= config.bin %> space list"
+        "# 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": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1700,7 +1515,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "space:list",
+      "id": "review:approve",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1711,21 +1526,69 @@
         "dist",
         "oclif",
         "commands",
-        "space",
-        "list.js"
+        "review",
+        "approve.js"
       ]
     },
-    "space:switch": {
+    "review:base-review-decision": {
+      "aliases": [],
+      "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",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "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": "Switch to a different space (deprecated)",
+      "description": "List all pending review operations for the current project",
       "examples": [
-        "<%= config.bin %> space switch"
+        "# Show all pending reviews",
+        "<%= config.bin %> review pending",
+        "",
+        "# Get structured output for agent-driven workflows",
+        "<%= config.bin %> review pending --format json"
       ],
       "flags": {
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1739,7 +1602,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "space:switch",
+      "id": "review:pending",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1750,8 +1613,67 @@
         "dist",
         "oclif",
         "commands",
-        "space",
-        "switch.js"
+        "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": {
@@ -1854,15 +1776,93 @@
           "required": true
         }
       },
-      "description": "Remove a knowledge source",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> shared-lib",
-        "<%= config.bin %> <%= command.id %> /path/to/shared-lib"
-      ],
-      "flags": {},
+      "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"
+      ]
+    },
+    "space:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all teams and spaces (deprecated)",
+      "examples": [
+        "<%= config.bin %> space list"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "space:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "space",
+        "list.js"
+      ]
+    },
+    "space:switch": {
+      "aliases": [],
+      "args": {},
+      "description": "Switch to a different space (deprecated)",
+      "examples": [
+        "<%= config.bin %> space switch"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "source:remove",
+      "id": "space:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1873,8 +1873,8 @@
         "dist",
         "oclif",
         "commands",
-        "source",
-        "remove.js"
+        "space",
+        "switch.js"
       ]
     },
     "swarm:curate": {
@@ -2057,6 +2057,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": {},
@@ -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.1"
 }

package/package.json

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