byterover-cli 3.3.0 → 3.5.0

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,6 +1216,261 @@
         "switch.js"
       ]
     },
+    "providers:connect": {
+      "aliases": [],
+      "args": {
+        "provider": {
+          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter). Omit for interactive selection.",
+          "name": "provider",
+          "required": false
+        }
+      },
+      "description": "Connect or switch to an LLM provider",
+      "examples": [
+        "<%= config.bin %> providers connect",
+        "<%= config.bin %> providers connect anthropic --api-key sk-xxx",
+        "<%= config.bin %> providers connect openai --oauth",
+        "<%= config.bin %> providers connect byterover",
+        "<%= config.bin %> providers connect openai-compatible --base-url http://localhost:11434/v1 --api-key sk-xxx"
+      ],
+      "flags": {
+        "api-key": {
+          "char": "k",
+          "description": "API key for the provider",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "char": "b",
+          "description": "Base URL for OpenAI-compatible providers (e.g., http://localhost:11434/v1)",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "code": {
+          "char": "c",
+          "description": "Authorization code for code-paste OAuth providers (e.g., Anthropic). Not applicable to browser-callback providers like OpenAI — use --oauth without --code instead.",
+          "hidden": true,
+          "name": "code",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "model": {
+          "char": "m",
+          "description": "Model to set as active after connecting",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "oauth": {
+          "description": "Connect via OAuth (browser-based)",
+          "name": "oauth",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "providers:connect",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "providers",
+        "connect.js"
+      ]
+    },
+    "providers:disconnect": {
+      "aliases": [],
+      "args": {
+        "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": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "providers:disconnect",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "providers",
+        "disconnect.js"
+      ]
+    },
+    "providers": {
+      "aliases": [],
+      "args": {},
+      "description": "Show active provider and model",
+      "examples": [
+        "<%= config.bin %> providers",
+        "<%= config.bin %> providers --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": "providers",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "providers",
+        "index.js"
+      ]
+    },
+    "providers:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all available providers and their connection status",
+      "examples": [
+        "<%= config.bin %> providers list",
+        "<%= config.bin %> providers list --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "providers:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "providers",
+        "list.js"
+      ]
+    },
+    "providers:switch": {
+      "aliases": [],
+      "args": {
+        "provider": {
+          "description": "Provider ID to switch to (e.g., anthropic, openai)",
+          "name": "provider",
+          "required": true
+        }
+      },
+      "description": "Switch the active provider",
+      "examples": [
+        "<%= config.bin %> providers switch anthropic",
+        "<%= config.bin %> providers switch openai --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "providers:switch",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "providers",
+        "switch.js"
+      ]
+    },
     "review:approve": {
       "aliases": [],
       "args": {
@@ -1499,79 +1754,33 @@
         "switch.js"
       ]
     },
-    "providers:connect": {
+    "source:add": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter). Omit for interactive selection.",
-          "name": "provider",
-          "required": false
+        "path": {
+          "description": "Path to the target project containing .brv/",
+          "name": "path",
+          "required": true
         }
       },
-      "description": "Connect or switch to an LLM provider",
+      "description": "Add a read-only knowledge source from another project's context tree",
       "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 %> <%= command.id %> /path/to/shared-lib",
+        "<%= config.bin %> <%= command.id %> /path/to/shared-lib --alias shared"
       ],
       "flags": {
-        "api-key": {
-          "char": "k",
-          "description": "API key for the provider",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "base-url": {
-          "char": "b",
-          "description": "Base URL for OpenAI-compatible providers (e.g., http://localhost:11434/v1)",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "code": {
-          "char": "c",
-          "description": "Authorization code for code-paste OAuth providers (e.g., Anthropic). Not applicable to browser-callback providers like OpenAI — use --oauth without --code instead.",
-          "hidden": true,
-          "name": "code",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        },
-        "model": {
-          "char": "m",
-          "description": "Model to set as active after connecting",
-          "name": "model",
+        "alias": {
+          "description": "Custom alias for the source (defaults to directory name)",
+          "name": "alias",
+          "required": false,
           "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": "source:add",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1582,41 +1791,118 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "connect.js"
+        "source",
+        "add.js"
       ]
     },
-    "providers:disconnect": {
+    "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": {
-        "provider": {
-          "description": "Provider ID to disconnect",
-          "name": "provider",
+        "aliasOrPath": {
+          "description": "Alias or path of the knowledge source to remove",
+          "name": "aliasOrPath",
           "required": true
         }
       },
-      "description": "Disconnect an LLM provider",
+      "description": "Remove a knowledge source",
       "examples": [
-        "<%= config.bin %> providers disconnect anthropic",
-        "<%= config.bin %> providers disconnect openai --format json"
+        "<%= 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"
+      ]
+    },
+    "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": {
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
+        "force": {
+          "description": "Replace existing .brv/ directory in target with a worktree pointer",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:disconnect",
+      "id": "worktree:add",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1627,35 +1913,21 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "disconnect.js"
+        "worktree",
+        "add.js"
       ]
     },
-    "providers": {
+    "worktree": {
       "aliases": [],
       "args": {},
-      "description": "Show active provider and model",
+      "description": "Manage worktree links for subdirectories and sibling checkouts",
       "examples": [
-        "<%= config.bin %> providers",
-        "<%= config.bin %> providers --format json"
+        "<%= config.bin %> <%= command.id %> --help"
       ],
-      "flags": {
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers",
+      "id": "worktree",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1666,35 +1938,53 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
+        "worktree",
         "index.js"
       ]
     },
-    "providers:list": {
+    "worktree:list": {
       "aliases": [],
       "args": {},
-      "description": "List all available providers and their connection status",
+      "description": "Show the current worktree link and list all registered worktrees",
       "examples": [
-        "<%= config.bin %> providers list",
-        "<%= config.bin %> providers list --format json"
+        "<%= config.bin %> <%= command.id %>"
       ],
-      "flags": {
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
+      "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": "providers:list",
+      "id": "worktree:remove",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1705,27 +1995,29 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "list.js"
+        "worktree",
+        "remove.js"
       ]
     },
-    "providers:switch": {
+    "swarm:curate": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to switch to (e.g., anthropic, openai)",
-          "name": "provider",
+        "content": {
+          "description": "Knowledge content to store in a swarm provider",
+          "name": "content",
           "required": true
         }
       },
-      "description": "Switch the active provider",
+      "description": "Store knowledge in a swarm provider (GBrain, local markdown)",
       "examples": [
-        "<%= config.bin %> providers switch anthropic",
-        "<%= config.bin %> providers switch openai --format json"
+        "<%= config.bin %> swarm curate \"Dario Amodei is CEO of Anthropic\"",
+        "<%= config.bin %> swarm curate \"meeting notes: decided on JWT\" --provider local-markdown:notes",
+        "<%= config.bin %> swarm curate \"Architecture uses event sourcing\" --provider gbrain"
       ],
       "flags": {
         "format": {
-          "description": "Output format (text or json)",
+          "char": "f",
+          "description": "Output format",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1735,44 +2027,11 @@
             "json"
           ],
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "providers:switch",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "providers",
-        "switch.js"
-      ]
-    },
-    "source:add": {
-      "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to the target project containing .brv/",
-          "name": "path",
-          "required": true
-        }
-      },
-      "description": "Add a read-only knowledge source from another project's context tree",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> /path/to/shared-lib",
-        "<%= config.bin %> <%= command.id %> /path/to/shared-lib --alias shared"
-      ],
-      "flags": {
-        "alias": {
-          "description": "Custom alias for the source (defaults to directory name)",
-          "name": "alias",
-          "required": false,
+        },
+        "provider": {
+          "char": "p",
+          "description": "Target provider ID (e.g., gbrain, local-markdown:notes)",
+          "name": "provider",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1780,7 +2039,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "source:add",
+      "id": "swarm:curate",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1791,21 +2050,21 @@
         "dist",
         "oclif",
         "commands",
-        "source",
-        "add.js"
+        "swarm",
+        "curate.js"
       ]
     },
-    "source": {
+    "swarm:onboard": {
       "aliases": [],
       "args": {},
-      "description": "Manage knowledge sources (read-only references to other projects)",
+      "description": "Set up memory swarm with interactive onboarding wizard",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --help"
+        "<%= config.bin %> swarm onboard"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "source",
+      "id": "swarm:onboard",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1816,21 +2075,56 @@
         "dist",
         "oclif",
         "commands",
-        "source",
-        "index.js"
+        "swarm",
+        "onboard.js"
       ]
     },
-    "source:list": {
+    "swarm:query": {
       "aliases": [],
-      "args": {},
-      "description": "List all knowledge sources and their status",
+      "args": {
+        "query": {
+          "description": "Natural language query to search across memory providers",
+          "name": "query",
+          "required": true
+        }
+      },
+      "description": "Query the memory swarm across all active providers",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> swarm query \"auth tokens\"",
+        "<%= config.bin %> swarm query \"what changed yesterday\" --format json"
       ],
-      "flags": {},
+      "flags": {
+        "explain": {
+          "description": "Show classification, routing, and enrichment details (ignored with --format json, which always includes all metadata)",
+          "name": "explain",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "max-results": {
+          "char": "n",
+          "description": "Maximum number of results",
+          "name": "max-results",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "source:list",
+      "id": "swarm:query",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1841,28 +2135,36 @@
         "dist",
         "oclif",
         "commands",
-        "source",
-        "list.js"
+        "swarm",
+        "query.js"
       ]
     },
-    "source:remove": {
+    "swarm:status": {
       "aliases": [],
-      "args": {
-        "aliasOrPath": {
-          "description": "Alias or path of the knowledge source to remove",
-          "name": "aliasOrPath",
-          "required": true
-        }
-      },
-      "description": "Remove a knowledge source",
+      "args": {},
+      "description": "Show memory swarm provider health and connection status",
       "examples": [
-        "<%= config.bin %> <%= command.id %> shared-lib",
-        "<%= config.bin %> <%= command.id %> /path/to/shared-lib"
+        "<%= config.bin %> swarm status",
+        "<%= config.bin %> swarm status --format json"
       ],
-      "flags": {},
+      "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": "swarm:status",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1873,8 +2175,8 @@
         "dist",
         "oclif",
         "commands",
-        "source",
-        "remove.js"
+        "swarm",
+        "status.js"
       ]
     },
     "vc:add": {
@@ -2479,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": {
@@ -2900,5 +3080,5 @@
       ]
     }
   },
-  "version": "3.3.0"
+  "version": "3.5.0"
 }