byterover-cli 3.2.0 → 3.3.0

package/oclif.manifest.json

@@ -416,6 +416,14 @@
             "json"
           ],
           "type": "option"
+        },
+        "timeout": {
+          "description": "Maximum seconds to wait for task completion",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -465,6 +473,71 @@
         "restart.js"
       ]
     },
+    "search": {
+      "aliases": [],
+      "args": {
+        "query": {
+          "description": "Search query to find relevant knowledge in the context tree",
+          "name": "query",
+          "required": true
+        }
+      },
+      "description": "Search the context tree for relevant knowledge\n\nReturns ranked results with paths, scores, and excerpts.\nPure BM25 retrieval — no LLM, no token cost.\n\nUse this for structured results with file paths.\nUse \"brv query\" when you need a synthesized answer.",
+      "examples": [
+        "# Search for knowledge about authentication",
+        "<%= config.bin %> <%= command.id %> \"authentication\"",
+        "",
+        "# Limit results and scope to a domain",
+        "<%= config.bin %> <%= command.id %> \"JWT tokens\" --limit 5 --scope auth/",
+        "",
+        "# JSON output (for automation)",
+        "<%= config.bin %> <%= command.id %> \"auth\" --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "limit": {
+          "description": "Maximum number of results (1-50)",
+          "name": "limit",
+          "default": 10,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "description": "Path prefix to scope results (e.g. \"auth/\" for auth domain only)",
+          "name": "scope",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "search",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "search.js"
+      ]
+    },
     "status": {
       "aliases": [],
       "args": {},
@@ -683,6 +756,9 @@
         "# Folder pack with context",
         "<%= config.bin %> <%= command.id %> \"Analyze authentication module\" -d src/auth/",
         "",
+        "# Increase timeout for slow models (in seconds)",
+        "<%= config.bin %> <%= command.id %> \"context here\" --timeout 600",
+        "",
         "# View curate history",
         "<%= config.bin %> curate view",
         "<%= config.bin %> curate view --status completed --since 1h"
@@ -721,6 +797,14 @@
             "json"
           ],
           "type": "option"
+        },
+        "timeout": {
+          "description": "Maximum seconds to wait for task completion",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -1132,47 +1216,33 @@
         "switch.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 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",
-          "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",
+        "file": {
+          "description": "Approve only the specified file path(s) (relative to context tree)",
+          "name": "file",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "format": {
@@ -1186,25 +1256,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": "review:approve",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1215,25 +1271,25 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "connect.js"
+        "review",
+        "approve.js"
       ]
     },
-    "providers:disconnect": {
+    "review:base-review-decision": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to disconnect",
-          "name": "provider",
+        "taskId": {
+          "name": "taskId",
           "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",
@@ -1249,7 +1305,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:disconnect",
+      "id": "review:base-review-decision",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1260,17 +1316,20 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "disconnect.js"
+        "review",
+        "base-review-decision.js"
       ]
     },
-    "providers": {
+    "review:pending": {
       "aliases": [],
       "args": {},
-      "description": "Show active provider and model",
+      "description": "List all pending review operations for the current project",
       "examples": [
-        "<%= config.bin %> providers",
-        "<%= config.bin %> providers --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": {
@@ -1288,7 +1347,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers",
+      "id": "review:pending",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1299,19 +1358,39 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "index.js"
+        "review",
+        "pending.js"
       ]
     },
-    "providers:list": {
+    "review:reject": {
       "aliases": [],
-      "args": {},
-      "description": "List all available providers and their connection status",
+      "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": [
-        "<%= config.bin %> providers list",
-        "<%= config.bin %> providers list --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",
@@ -1327,7 +1406,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:list",
+      "id": "review:reject",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1338,27 +1417,21 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "list.js"
+        "review",
+        "reject.js"
       ]
     },
-    "providers:switch": {
+    "space:list": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "Provider ID to switch to (e.g., anthropic, openai)",
-          "name": "provider",
-          "required": true
-        }
-      },
-      "description": "Switch the active provider",
+      "args": {},
+      "description": "List all teams and spaces (deprecated)",
       "examples": [
-        "<%= config.bin %> providers switch anthropic",
-        "<%= config.bin %> providers switch openai --format json"
+        "<%= config.bin %> space list"
       ],
       "flags": {
         "format": {
-          "description": "Output format (text or json)",
+          "char": "f",
+          "description": "Output format",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1372,7 +1445,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:switch",
+      "id": "space:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1383,164 +1456,21 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "switch.js"
+        "space",
+        "list.js"
       ]
     },
-    "source:add": {
+    "space:switch": {
       "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",
+      "args": {},
+      "description": "Switch to a different space (deprecated)",
       "examples": [
-        "<%= config.bin %> <%= command.id %> /path/to/shared-lib",
-        "<%= config.bin %> <%= command.id %> /path/to/shared-lib --alias shared"
+        "<%= config.bin %> space switch"
       ],
       "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"
-      ]
-    },
-    "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)",
+          "char": "f",
+          "description": "Output format",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1554,7 +1484,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:approve",
+      "id": "space:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1565,23 +1495,51 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "approve.js"
+        "space",
+        "switch.js"
       ]
     },
-    "review:base-review-decision": {
+    "providers:connect": {
       "aliases": [],
       "args": {
-        "taskId": {
-          "name": "taskId",
-          "required": true
+        "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 openai-compatible --base-url http://localhost:11434/v1 --api-key sk-xxx"
+      ],
       "flags": {
-        "file": {
-          "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": {
@@ -1595,11 +1553,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:base-review-decision",
+      "id": "providers:connect",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1610,20 +1582,23 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "base-review-decision.js"
+        "providers",
+        "connect.js"
       ]
     },
-    "review:pending": {
+    "providers:disconnect": {
       "aliases": [],
-      "args": {},
-      "description": "List all pending review operations for the current project",
+      "args": {
+        "provider": {
+          "description": "Provider ID to disconnect",
+          "name": "provider",
+          "required": true
+        }
+      },
+      "description": "Disconnect an LLM provider",
       "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 disconnect anthropic",
+        "<%= config.bin %> providers disconnect openai --format json"
       ],
       "flags": {
         "format": {
@@ -1641,7 +1616,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:pending",
+      "id": "providers:disconnect",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1652,39 +1627,19 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "pending.js"
+        "providers",
+        "disconnect.js"
       ]
     },
-    "review:reject": {
+    "providers": {
       "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": "Show active provider and model",
       "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",
+        "<%= config.bin %> providers --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",
@@ -1700,7 +1655,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:reject",
+      "id": "providers",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1711,21 +1666,21 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "reject.js"
+        "providers",
+        "index.js"
       ]
     },
-    "space:list": {
+    "providers:list": {
       "aliases": [],
       "args": {},
-      "description": "List all teams and spaces (deprecated)",
+      "description": "List all available providers and their connection status",
       "examples": [
-        "<%= config.bin %> space list"
+        "<%= config.bin %> providers list",
+        "<%= config.bin %> providers list --format json"
       ],
       "flags": {
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1739,7 +1694,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "space:list",
+      "id": "providers:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1750,21 +1705,27 @@
         "dist",
         "oclif",
         "commands",
-        "space",
+        "providers",
         "list.js"
       ]
     },
-    "space:switch": {
+    "providers:switch": {
       "aliases": [],
-      "args": {},
-      "description": "Switch to a different space (deprecated)",
+      "args": {
+        "provider": {
+          "description": "Provider ID to switch to (e.g., anthropic, openai)",
+          "name": "provider",
+          "required": true
+        }
+      },
+      "description": "Switch the active provider",
       "examples": [
-        "<%= config.bin %> space switch"
+        "<%= config.bin %> providers switch anthropic",
+        "<%= config.bin %> providers switch openai --format json"
       ],
       "flags": {
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1778,7 +1739,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "space:switch",
+      "id": "providers:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1789,36 +1750,37 @@
         "dist",
         "oclif",
         "commands",
-        "space",
+        "providers",
         "switch.js"
       ]
     },
-    "worktree:add": {
+    "source:add": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to the directory to register as a worktree (relative or absolute)",
+          "description": "Path to the target project containing .brv/",
           "name": "path",
-          "required": false
+          "required": true
         }
       },
-      "description": "Register a directory as a worktree of this project",
+      "description": "Add a read-only knowledge source from another project's context tree",
       "examples": [
-        "<%= config.bin %> <%= command.id %> packages/api",
-        "<%= config.bin %> <%= command.id %> ../other-checkout",
-        "<%= config.bin %> <%= command.id %>  (auto-detect parent from subdirectory)"
+        "<%= config.bin %> <%= command.id %> /path/to/shared-lib",
+        "<%= config.bin %> <%= command.id %> /path/to/shared-lib --alias shared"
       ],
       "flags": {
-        "force": {
-          "description": "Replace existing .brv/ directory in target with a worktree pointer",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
+        "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": "worktree:add",
+      "id": "source:add",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1829,21 +1791,21 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
+        "source",
         "add.js"
       ]
     },
-    "worktree": {
+    "source": {
       "aliases": [],
       "args": {},
-      "description": "Manage worktree links for subdirectories and sibling checkouts",
+      "description": "Manage knowledge sources (read-only references to other projects)",
       "examples": [
         "<%= config.bin %> <%= command.id %> --help"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree",
+      "id": "source",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1854,21 +1816,21 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
+        "source",
         "index.js"
       ]
     },
-    "worktree:list": {
+    "source:list": {
       "aliases": [],
       "args": {},
-      "description": "Show the current worktree link and list all registered worktrees",
+      "description": "List all knowledge sources and their status",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree:list",
+      "id": "source:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1879,28 +1841,28 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
+        "source",
         "list.js"
       ]
     },
-    "worktree:remove": {
+    "source:remove": {
       "aliases": [],
       "args": {
-        "path": {
-          "description": "Path to the worktree to remove (defaults to cwd)",
-          "name": "path",
-          "required": false
+        "aliasOrPath": {
+          "description": "Alias or path of the knowledge source to remove",
+          "name": "aliasOrPath",
+          "required": true
         }
       },
-      "description": "Remove a worktree registration and its .brv pointer",
+      "description": "Remove a knowledge source",
       "examples": [
-        "<%= config.bin %> <%= command.id %>  (remove cwd as worktree)",
-        "<%= config.bin %> <%= command.id %> packages/api  (remove from parent)"
+        "<%= config.bin %> <%= command.id %> shared-lib",
+        "<%= config.bin %> <%= command.id %> /path/to/shared-lib"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree:remove",
+      "id": "source:remove",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1911,7 +1873,7 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
+        "source",
         "remove.js"
       ]
     },
@@ -2517,6 +2479,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"
+      ]
+    },
     "hub:registry:add": {
       "aliases": [],
       "args": {
@@ -2816,5 +2900,5 @@
       ]
     }
   },
-  "version": "3.2.0"
+  "version": "3.3.0"
 }