byterover-cli 3.10.3 → 3.12.0

package/oclif.manifest.json

@@ -1396,58 +1396,79 @@
         "switch.js"
       ]
     },
-    "query-log:summary": {
+    "providers:connect": {
       "aliases": [],
-      "args": {},
-      "description": "View aggregated query recall metrics (coverage, cache hit rate, top topics)",
+      "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 %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --last 24h",
-        "<%= config.bin %> <%= command.id %> --last 7d",
-        "<%= config.bin %> <%= command.id %> --last 30d",
-        "<%= config.bin %> <%= command.id %> --format json",
-        "<%= config.bin %> <%= command.id %> --format narrative",
-        "<%= config.bin %> <%= command.id %> --since 2026-04-01 --before 2026-04-03"
+        "<%= 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": {
-        "before": {
-          "description": "Entries before (ISO date or relative: 1h, 24h, 7d, 2w)",
-          "name": "before",
+        "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",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
             "text",
-            "json",
-            "narrative"
+            "json"
           ],
           "type": "option"
         },
-        "last": {
-          "description": "Relative time window (e.g., 1h, 24h, 7d, 30d). Default: 24h. Takes precedence over --since.",
-          "name": "last",
+        "model": {
+          "char": "m",
+          "description": "Model to set as active after connecting",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "since": {
-          "description": "Entries after (ISO date or relative: 1h, 24h, 7d, 2w)",
-          "name": "since",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "oauth": {
+          "description": "Connect via OAuth (browser-based)",
+          "name": "oauth",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "query-log:summary",
+      "id": "providers:connect",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1458,49 +1479,27 @@
         "dist",
         "oclif",
         "commands",
-        "query-log",
-        "summary.js"
+        "providers",
+        "connect.js"
       ]
     },
-    "query-log:view": {
+    "providers:disconnect": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Query log entry ID to view in detail",
-          "name": "id",
-          "required": false
+        "provider": {
+          "description": "Provider ID to disconnect",
+          "name": "provider",
+          "required": true
         }
       },
-      "description": "View query log history",
+      "description": "Disconnect an LLM provider",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> qry-1712345678901",
-        "<%= config.bin %> <%= command.id %> --limit 20",
-        "<%= config.bin %> <%= command.id %> --status completed",
-        "<%= config.bin %> <%= command.id %> --status completed --status error",
-        "<%= config.bin %> <%= command.id %> --tier 0 --tier 1",
-        "<%= config.bin %> <%= command.id %> --since 1h",
-        "<%= config.bin %> <%= command.id %> --since 2024-01-15",
-        "<%= config.bin %> <%= command.id %> --before 2024-02-01",
-        "<%= config.bin %> <%= command.id %> --detail",
-        "<%= config.bin %> <%= command.id %> --format json"
+        "<%= config.bin %> providers disconnect anthropic",
+        "<%= config.bin %> providers disconnect openai --format json"
       ],
       "flags": {
-        "before": {
-          "description": "Show entries started before this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)",
-          "name": "before",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "detail": {
-          "description": "Show matched docs for each entry",
-          "name": "detail",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "format": {
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1510,53 +1509,11 @@
             "json"
           ],
           "type": "option"
-        },
-        "limit": {
-          "description": "Maximum number of log entries to display",
-          "name": "limit",
-          "default": 10,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "since": {
-          "description": "Show entries started after this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)",
-          "name": "since",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "status": {
-          "description": "Filter by status (can be repeated). Options: cancelled, completed, error, processing",
-          "name": "status",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "cancelled",
-            "completed",
-            "error",
-            "processing"
-          ],
-          "type": "option"
-        },
-        "tier": {
-          "description": "Filter by resolution tier (can be repeated). Options: 0, 1, 2, 3, 4",
-          "name": "tier",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "0",
-            "1",
-            "2",
-            "3",
-            "4"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "query-log:view",
+      "id": "providers:disconnect",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1567,39 +1524,19 @@
         "dist",
         "oclif",
         "commands",
-        "query-log",
-        "view.js"
+        "providers",
+        "disconnect.js"
       ]
     },
-    "review:approve": {
+    "providers": {
       "aliases": [],
-      "args": {
-        "taskId": {
-          "description": "Task ID shown in the curate output (e.g. \"brv review approve abc-123\")",
-          "name": "taskId",
-          "required": true
-        }
-      },
-      "description": "Approve pending review operations for a curate task",
+      "args": {},
+      "description": "Show active provider and model",
       "examples": [
-        "# Approve all pending changes from a curate task",
-        "<%= config.bin %> review approve abc-123",
-        "",
-        "# Approve specific files",
-        "<%= config.bin %> review approve abc-123 --file architecture/security/audit.md",
-        "<%= config.bin %> review approve abc-123 --file auth/jwt.md --file auth/oauth.md",
-        "",
-        "# Approve and get structured output (useful for coding agents)",
-        "<%= config.bin %> review approve abc-123 --format json"
+        "<%= config.bin %> providers",
+        "<%= config.bin %> providers --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",
@@ -1615,7 +1552,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:approve",
+      "id": "providers",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1626,25 +1563,19 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "approve.js"
+        "providers",
+        "index.js"
       ]
     },
-    "review:base-review-decision": {
+    "providers:list": {
       "aliases": [],
-      "args": {
-        "taskId": {
-          "name": "taskId",
-          "required": true
-        }
-      },
+      "args": {},
+      "description": "List all available providers and their connection status",
+      "examples": [
+        "<%= config.bin %> providers list",
+        "<%= config.bin %> providers list --format json"
+      ],
       "flags": {
-        "file": {
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
         "format": {
           "description": "Output format (text or json)",
           "name": "format",
@@ -1660,7 +1591,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:base-review-decision",
+      "id": "providers:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1671,20 +1602,23 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "base-review-decision.js"
+        "providers",
+        "list.js"
       ]
     },
-    "review:pending": {
+    "providers:switch": {
       "aliases": [],
-      "args": {},
-      "description": "List all pending review operations for the current project",
+      "args": {
+        "provider": {
+          "description": "Provider ID to switch to (e.g., anthropic, openai)",
+          "name": "provider",
+          "required": true
+        }
+      },
+      "description": "Switch the active 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 switch anthropic",
+        "<%= config.bin %> providers switch openai --format json"
       ],
       "flags": {
         "format": {
@@ -1702,7 +1636,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "review:pending",
+      "id": "providers:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1713,15 +1647,161 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "pending.js"
+        "providers",
+        "switch.js"
       ]
     },
-    "review:reject": {
+    "review:approve": {
       "aliases": [],
       "args": {
         "taskId": {
-          "description": "Task ID shown in the curate output (e.g. \"brv review reject abc-123\")",
+          "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
         }
@@ -1977,47 +2057,32 @@
         "switch.js"
       ]
     },
-    "swarm:curate": {
+    "worktree:add": {
       "aliases": [],
       "args": {
-        "content": {
-          "description": "Knowledge content to store in a swarm provider",
-          "name": "content",
-          "required": true
+        "path": {
+          "description": "Path to the directory to register as a worktree (relative or absolute)",
+          "name": "path",
+          "required": false
         }
       },
-      "description": "Store knowledge in a swarm provider (GBrain, local markdown)",
+      "description": "Register a directory as a worktree of this project",
       "examples": [
-        "<%= 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"
+        "<%= config.bin %> <%= command.id %> packages/api",
+        "<%= config.bin %> <%= command.id %> ../other-checkout",
+        "<%= config.bin %> <%= command.id %>  (auto-detect parent from subdirectory)"
       ],
       "flags": {
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        },
-        "provider": {
-          "char": "p",
-          "description": "Target provider ID (e.g., gbrain, local-markdown:notes)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "force": {
+          "description": "Replace existing .brv/ directory in target with a worktree pointer",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "swarm:curate",
+      "id": "worktree:add",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2028,21 +2093,21 @@
         "dist",
         "oclif",
         "commands",
-        "swarm",
-        "curate.js"
+        "worktree",
+        "add.js"
       ]
     },
-    "swarm:onboard": {
+    "worktree": {
       "aliases": [],
       "args": {},
-      "description": "Set up memory swarm with interactive onboarding wizard",
+      "description": "Manage worktree links for subdirectories and sibling checkouts",
       "examples": [
-        "<%= config.bin %> swarm onboard"
+        "<%= config.bin %> <%= command.id %> --help"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "swarm:onboard",
+      "id": "worktree",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2053,56 +2118,21 @@
         "dist",
         "oclif",
         "commands",
-        "swarm",
-        "onboard.js"
+        "worktree",
+        "index.js"
       ]
     },
-    "swarm:query": {
+    "worktree:list": {
       "aliases": [],
-      "args": {
-        "query": {
-          "description": "Natural language query to search across memory providers",
-          "name": "query",
-          "required": true
-        }
-      },
-      "description": "Query the memory swarm across all active providers",
+      "args": {},
+      "description": "Show the current worktree link and list all registered worktrees",
       "examples": [
-        "<%= config.bin %> swarm query \"auth tokens\"",
-        "<%= config.bin %> swarm query \"what changed yesterday\" --format json"
+        "<%= config.bin %> <%= command.id %>"
       ],
-      "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"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "swarm:query",
+      "id": "worktree:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2113,36 +2143,113 @@
         "dist",
         "oclif",
         "commands",
-        "swarm",
-        "query.js"
+        "worktree",
+        "list.js"
       ]
     },
-    "swarm:status": {
+    "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": {},
-      "description": "Show memory swarm provider health and connection status",
+      "description": "Stage files for the next commit",
       "examples": [
-        "<%= config.bin %> swarm status",
-        "<%= config.bin %> swarm status --format json"
+        "<%= config.bin %> <%= command.id %> .",
+        "<%= config.bin %> <%= command.id %> notes.md",
+        "<%= config.bin %> <%= command.id %> design/architecture.md",
+        "<%= config.bin %> <%= command.id %> docs/"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "vc:add",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "vc",
+        "add.js"
+      ]
+    },
+    "vc:branch": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Branch name to create",
+          "name": "name"
+        }
+      },
+      "description": "List, create, or delete local branches",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> feature/new-context",
+        "<%= config.bin %> <%= command.id %> -d feature/new-context",
+        "<%= config.bin %> <%= command.id %> -a",
+        "<%= config.bin %> <%= command.id %> --set-upstream-to origin/main"
       ],
       "flags": {
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
+        "all": {
+          "char": "a",
+          "description": "List all branches including remote-tracking",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "delete": {
+          "char": "d",
+          "description": "Delete a branch by name",
+          "name": "delete",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "set-upstream-to": {
+          "description": "Set upstream tracking (e.g. origin/main)",
+          "name": "set-upstream-to",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "swarm:status",
+      "id": "vc:branch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2153,28 +2260,35 @@
         "dist",
         "oclif",
         "commands",
-        "swarm",
-        "status.js"
+        "vc",
+        "branch.js"
       ]
     },
-    "worktree:add": {
+    "vc:checkout": {
       "aliases": [],
       "args": {
-        "path": {
-          "description": "Path to the directory to register as a worktree (relative or absolute)",
-          "name": "path",
-          "required": false
+        "branch": {
+          "description": "Branch to switch to",
+          "name": "branch",
+          "required": true
         }
       },
-      "description": "Register a directory as a worktree of this project",
+      "description": "Switch to an existing branch, or create and switch with -b",
       "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 %> feature/my-branch",
+        "<%= config.bin %> <%= command.id %> -b feature/new-branch",
+        "<%= config.bin %> <%= command.id %> --force feature/my-branch"
       ],
       "flags": {
+        "create": {
+          "char": "b",
+          "description": "Create a new branch and switch to it",
+          "name": "create",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "force": {
-          "description": "Replace existing .brv/ directory in target with a worktree pointer",
+          "description": "Discard local changes and switch",
           "name": "force",
           "allowNo": false,
           "type": "boolean"
@@ -2182,7 +2296,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree:add",
+      "id": "vc:checkout",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2193,21 +2307,26 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
-        "add.js"
+        "vc",
+        "checkout.js"
       ]
     },
-    "worktree": {
+    "vc:clone": {
       "aliases": [],
-      "args": {},
-      "description": "Manage worktree links for subdirectories and sibling checkouts",
+      "args": {
+        "url": {
+          "description": "Clone URL (e.g. https://byterover.dev/<team>/<space>.git)",
+          "name": "url"
+        }
+      },
+      "description": "Clone a ByteRover space repository",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --help"
+        "<%= config.bin %> vc clone https://byterover.dev/acme/project.git"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree",
+      "id": "vc:clone",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2218,53 +2337,68 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
-        "index.js"
+        "vc",
+        "clone.js"
       ]
     },
-    "worktree:list": {
+    "vc:commit": {
       "aliases": [],
       "args": {},
-      "description": "Show the current worktree link and list all registered worktrees",
+      "description": "Save staged changes as a commit",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> -m \"Add project architecture notes\""
       ],
-      "flags": {},
+      "flags": {
+        "message": {
+          "char": "m",
+          "description": "Commit message",
+          "name": "message",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree:list",
+      "id": "vc:commit",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "oclif",
         "commands",
-        "worktree",
-        "list.js"
+        "vc",
+        "commit.js"
       ]
     },
-    "worktree:remove": {
+    "vc:config": {
       "aliases": [],
       "args": {
-        "path": {
-          "description": "Path to the worktree to remove (defaults to cwd)",
-          "name": "path",
-          "required": false
+        "key": {
+          "description": "Config key (user.name or user.email)",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "Value to set (omit to read current value)",
+          "name": "value"
         }
       },
-      "description": "Remove a worktree registration and its .brv pointer",
+      "description": "Get or set commit author for ByteRover version control",
       "examples": [
-        "<%= config.bin %> <%= command.id %>  (remove cwd as worktree)",
-        "<%= config.bin %> <%= command.id %> packages/api  (remove from parent)"
+        "<%= config.bin %> <%= command.id %> user.name \"Your Name\"",
+        "<%= config.bin %> <%= command.id %> user.email \"you@example.com\"",
+        "<%= config.bin %> <%= command.id %> user.name",
+        "<%= config.bin %> <%= command.id %> user.email"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree:remove",
+      "id": "vc:config",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2275,83 +2409,37 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
-        "remove.js"
+        "vc",
+        "config.js"
       ]
     },
-    "providers:connect": {
+    "vc:diff": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter). Omit for interactive selection.",
-          "name": "provider",
-          "required": false
+        "ref": {
+          "description": "commit, branch, or <ref1>..<ref2> range",
+          "name": "ref"
         }
       },
-      "description": "Connect or switch to an LLM provider",
+      "description": "Show changes between commits, the index, or the working 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 %>",
+        "<%= config.bin %> <%= command.id %> --staged",
+        "<%= config.bin %> <%= command.id %> HEAD~1",
+        "<%= config.bin %> <%= command.id %> main..feature/x",
+        "<%= config.bin %> <%= command.id %> main"
       ],
       "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",
+        "staged": {
+          "description": "Show staged changes (HEAD vs index)",
+          "name": "staged",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:connect",
+      "id": "vc:diff",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2362,41 +2450,34 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "connect.js"
+        "vc",
+        "diff.js"
       ]
     },
-    "providers:disconnect": {
+    "vc:fetch": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to disconnect",
-          "name": "provider",
-          "required": true
+        "remote": {
+          "description": "Remote name (only origin supported)",
+          "name": "remote",
+          "required": false
+        },
+        "branch": {
+          "description": "Branch to fetch",
+          "name": "branch",
+          "required": false
         }
       },
-      "description": "Disconnect an LLM provider",
+      "description": "Fetch refs from ByteRover cloud",
       "examples": [
-        "<%= config.bin %> providers disconnect anthropic",
-        "<%= config.bin %> providers disconnect openai --format json"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> origin",
+        "<%= config.bin %> <%= command.id %> origin main"
       ],
-      "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:disconnect",
+      "id": "vc:fetch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2407,35 +2488,21 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "disconnect.js"
+        "vc",
+        "fetch.js"
       ]
     },
-    "providers": {
+    "vc": {
       "aliases": [],
       "args": {},
-      "description": "Show active provider and model",
+      "description": "Version control commands for the context tree",
       "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": "vc",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2446,35 +2513,21 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
+        "vc",
         "index.js"
       ]
     },
-    "providers:list": {
+    "vc:init": {
       "aliases": [],
       "args": {},
-      "description": "List all available providers and their connection status",
+      "description": "Initialize ByteRover version control for context tree",
       "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": "providers:list",
+      "id": "vc:init",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2485,41 +2538,45 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "list.js"
+        "vc",
+        "init.js"
       ]
     },
-    "providers:switch": {
+    "vc:log": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to switch to (e.g., anthropic, openai)",
-          "name": "provider",
-          "required": true
+        "branch": {
+          "description": "Branch name to show history for",
+          "name": "branch"
         }
       },
-      "description": "Switch the active provider",
+      "description": "Show commit history for the context-tree",
       "examples": [
-        "<%= config.bin %> providers switch anthropic",
-        "<%= config.bin %> providers switch openai --format json"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --limit 20",
+        "<%= config.bin %> <%= command.id %> main",
+        "<%= config.bin %> <%= command.id %> --all"
       ],
       "flags": {
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
+        "all": {
+          "char": "a",
+          "description": "Show commits from all branches",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Number of commits to show",
+          "name": "limit",
+          "default": 10,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:switch",
+      "id": "vc:log",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2530,66 +2587,297 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "switch.js"
+        "vc",
+        "log.js"
       ]
     },
-    "hub:registry:add": {
+    "vc:merge": {
       "aliases": [],
       "args": {
-        "name": {
-          "description": "Registry name",
-          "name": "name",
-          "required": true
+        "branch": {
+          "description": "Branch to merge into the current branch",
+          "name": "branch",
+          "required": false
         }
       },
-      "description": "Add a hub registry",
+      "description": "Merge a branch into the current branch",
       "examples": [
-        "<%= config.bin %> hub registry add myco --url https://example.com/registry.json",
-        "<%= config.bin %> hub registry add myco --url https://example.com/registry.json --token secret",
-        "<%= config.bin %> hub registry add ghrepo --url https://raw.githubusercontent.com/org/repo/main/registry.json --auth-scheme token --token ghp_xxx",
-        "<%= config.bin %> hub registry add gitlab --url https://gitlab.com/.../registry.json --auth-scheme custom-header --header-name PRIVATE-TOKEN --token glpat-xxx"
+        "<%= config.bin %> <%= command.id %> feature/my-branch",
+        "<%= config.bin %> <%= command.id %> --abort",
+        "<%= config.bin %> <%= command.id %> --continue",
+        "<%= config.bin %> <%= command.id %> -m \"Custom merge message\" feature/my-branch"
       ],
       "flags": {
-        "auth-scheme": {
-          "char": "s",
-          "description": "Auth scheme for hub registry",
-          "name": "auth-scheme",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "bearer",
-            "token",
-            "basic",
-            "custom-header",
-            "none"
+        "abort": {
+          "description": "Abort the current merge",
+          "exclusive": [
+            "continue"
           ],
-          "type": "option"
+          "name": "abort",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
+        "allow-unrelated-histories": {
+          "description": "Allow merging unrelated histories",
+          "name": "allow-unrelated-histories",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "header-name": {
-          "description": "Custom header name (for custom-header auth scheme)",
-          "name": "header-name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "continue": {
+          "description": "Continue the current merge after resolving conflicts",
+          "exclusive": [
+            "abort"
+          ],
+          "name": "continue",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "token": {
-          "char": "t",
-          "description": "Auth token for private hub registry",
-          "name": "token",
+        "message": {
+          "char": "m",
+          "description": "Merge commit message",
+          "name": "message",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "vc:merge",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "vc",
+        "merge.js"
+      ]
+    },
+    "vc:pull": {
+      "aliases": [],
+      "args": {
+        "remote": {
+          "description": "Remote name (only origin supported)",
+          "name": "remote",
+          "required": false
+        },
+        "branch": {
+          "description": "Branch to pull",
+          "name": "branch",
+          "required": false
+        }
+      },
+      "description": "Pull commits from ByteRover cloud",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> origin main",
+        "<%= config.bin %> <%= command.id %> origin main --allow-unrelated-histories"
+      ],
+      "flags": {
+        "allow-unrelated-histories": {
+          "description": "Allow merging unrelated histories",
+          "name": "allow-unrelated-histories",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "vc:pull",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "vc",
+        "pull.js"
+      ]
+    },
+    "vc:push": {
+      "aliases": [],
+      "args": {
+        "remote": {
+          "description": "Remote name (only origin supported)",
+          "name": "remote",
+          "required": false
+        },
+        "branch": {
+          "description": "Branch to push",
+          "name": "branch",
+          "required": false
+        }
+      },
+      "description": "Push commits to ByteRover cloud",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> -u",
+        "<%= config.bin %> <%= command.id %> origin feat/my-branch"
+      ],
+      "flags": {
+        "set-upstream": {
+          "char": "u",
+          "description": "Set upstream tracking branch",
+          "name": "set-upstream",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "vc:push",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "vc",
+        "push.js"
+      ]
+    },
+    "vc:reset": {
+      "aliases": [],
+      "args": {},
+      "description": "Unstage files or undo commits",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> notes.md",
+        "<%= config.bin %> <%= command.id %> --soft HEAD~1",
+        "<%= config.bin %> <%= command.id %> --hard HEAD~1",
+        "<%= config.bin %> <%= command.id %> --hard"
+      ],
+      "flags": {
+        "hard": {
+          "description": "Reset HEAD, index, and working tree",
+          "exclusive": [
+            "soft"
+          ],
+          "name": "hard",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "soft": {
+          "description": "Reset HEAD only, keep changes staged",
+          "exclusive": [
+            "hard"
+          ],
+          "name": "soft",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "vc:reset",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "vc",
+        "reset.js"
+      ]
+    },
+    "vc:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Show ByteRover version control status",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "vc:status",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "vc",
+        "status.js"
+      ]
+    },
+    "hub:registry:add": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Registry name",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Add a hub registry",
+      "examples": [
+        "<%= config.bin %> hub registry add myco --url https://example.com/registry.json",
+        "<%= config.bin %> hub registry add myco --url https://example.com/registry.json --token secret",
+        "<%= config.bin %> hub registry add ghrepo --url https://raw.githubusercontent.com/org/repo/main/registry.json --auth-scheme token --token ghp_xxx",
+        "<%= config.bin %> hub registry add gitlab --url https://gitlab.com/.../registry.json --auth-scheme custom-header --header-name PRIVATE-TOKEN --token glpat-xxx"
+      ],
+      "flags": {
+        "auth-scheme": {
+          "char": "s",
+          "description": "Auth scheme for hub registry",
+          "name": "auth-scheme",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "bearer",
+            "token",
+            "basic",
+            "custom-header",
+            "none"
+          ],
+          "type": "option"
+        },
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "header-name": {
+          "description": "Custom header name (for custom-header auth scheme)",
+          "name": "header-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "char": "t",
+          "description": "Auth token for private hub registry",
+          "name": "token",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2732,69 +3020,39 @@
         "remove.js"
       ]
     },
-    "vc:add": {
+    "swarm:curate": {
       "aliases": [],
-      "args": {},
-      "description": "Stage files for the next commit",
+      "args": {
+        "content": {
+          "description": "Knowledge content to store in a swarm provider",
+          "name": "content",
+          "required": true
+        }
+      },
+      "description": "Store knowledge in a swarm provider (GBrain, local markdown)",
       "examples": [
-        "<%= config.bin %> <%= command.id %> .",
-        "<%= config.bin %> <%= command.id %> notes.md",
-        "<%= config.bin %> <%= command.id %> design/architecture.md",
-        "<%= config.bin %> <%= command.id %> docs/"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:add",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": false,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "add.js"
-      ]
-    },
-    "vc:branch": {
-      "aliases": [],
-      "args": {
-        "name": {
-          "description": "Branch name to create",
-          "name": "name"
-        }
-      },
-      "description": "List, create, or delete local branches",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> feature/new-context",
-        "<%= config.bin %> <%= command.id %> -d feature/new-context",
-        "<%= config.bin %> <%= command.id %> -a",
-        "<%= config.bin %> <%= command.id %> --set-upstream-to origin/main"
+        "<%= 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": {
-        "all": {
-          "char": "a",
-          "description": "List all branches including remote-tracking",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "delete": {
-          "char": "d",
-          "description": "Delete a branch by name",
-          "name": "delete",
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
           "type": "option"
         },
-        "set-upstream-to": {
-          "description": "Set upstream tracking (e.g. origin/main)",
-          "name": "set-upstream-to",
+        "provider": {
+          "char": "p",
+          "description": "Target provider ID (e.g., gbrain, local-markdown:notes)",
+          "name": "provider",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2802,7 +3060,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:branch",
+      "id": "swarm:curate",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2813,43 +3071,21 @@
         "dist",
         "oclif",
         "commands",
-        "vc",
-        "branch.js"
+        "swarm",
+        "curate.js"
       ]
     },
-    "vc:checkout": {
+    "swarm:onboard": {
       "aliases": [],
-      "args": {
-        "branch": {
-          "description": "Branch to switch to",
-          "name": "branch",
-          "required": true
-        }
-      },
-      "description": "Switch to an existing branch, or create and switch with -b",
+      "args": {},
+      "description": "Set up memory swarm with interactive onboarding wizard",
       "examples": [
-        "<%= config.bin %> <%= command.id %> feature/my-branch",
-        "<%= config.bin %> <%= command.id %> -b feature/new-branch",
-        "<%= config.bin %> <%= command.id %> --force feature/my-branch"
+        "<%= config.bin %> swarm onboard"
       ],
-      "flags": {
-        "create": {
-          "char": "b",
-          "description": "Create a new branch and switch to it",
-          "name": "create",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "force": {
-          "description": "Discard local changes and switch",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:checkout",
+      "id": "swarm:onboard",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2860,26 +3096,56 @@
         "dist",
         "oclif",
         "commands",
-        "vc",
-        "checkout.js"
+        "swarm",
+        "onboard.js"
       ]
     },
-    "vc:clone": {
+    "swarm:query": {
       "aliases": [],
       "args": {
-        "url": {
-          "description": "Clone URL (e.g. https://byterover.dev/<team>/<space>.git)",
-          "name": "url"
+        "query": {
+          "description": "Natural language query to search across memory providers",
+          "name": "query",
+          "required": true
         }
       },
-      "description": "Clone a ByteRover space repository",
+      "description": "Query the memory swarm across all active providers",
       "examples": [
-        "<%= config.bin %> vc clone https://byterover.dev/acme/project.git"
+        "<%= 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": "vc:clone",
+      "id": "swarm:query",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2890,68 +3156,102 @@
         "dist",
         "oclif",
         "commands",
-        "vc",
-        "clone.js"
+        "swarm",
+        "query.js"
       ]
     },
-    "vc:commit": {
+    "swarm:status": {
       "aliases": [],
       "args": {},
-      "description": "Save staged changes as a commit",
+      "description": "Show memory swarm provider health and connection status",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -m \"Add project architecture notes\""
+        "<%= config.bin %> swarm status",
+        "<%= config.bin %> swarm status --format json"
       ],
       "flags": {
-        "message": {
-          "char": "m",
-          "description": "Commit message",
-          "name": "message",
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:commit",
+      "id": "swarm:status",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "oclif",
         "commands",
-        "vc",
-        "commit.js"
+        "swarm",
+        "status.js"
       ]
     },
-    "vc:config": {
+    "query-log:summary": {
       "aliases": [],
-      "args": {
-        "key": {
-          "description": "Config key (user.name or user.email)",
-          "name": "key",
-          "required": true
+      "args": {},
+      "description": "View aggregated query recall metrics (coverage, cache hit rate, top topics)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --last 24h",
+        "<%= config.bin %> <%= command.id %> --last 7d",
+        "<%= config.bin %> <%= command.id %> --last 30d",
+        "<%= config.bin %> <%= command.id %> --format json",
+        "<%= config.bin %> <%= command.id %> --format narrative",
+        "<%= config.bin %> <%= command.id %> --since 2026-04-01 --before 2026-04-03"
+      ],
+      "flags": {
+        "before": {
+          "description": "Entries before (ISO date or relative: 1h, 24h, 7d, 2w)",
+          "name": "before",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "value": {
-          "description": "Value to set (omit to read current value)",
-          "name": "value"
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "narrative"
+          ],
+          "type": "option"
+        },
+        "last": {
+          "description": "Relative time window (e.g., 1h, 24h, 7d, 30d). Default: 24h. Takes precedence over --since.",
+          "name": "last",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "since": {
+          "description": "Entries after (ISO date or relative: 1h, 24h, 7d, 2w)",
+          "name": "since",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
-      "description": "Get or set commit author for ByteRover version control",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> user.name \"Your Name\"",
-        "<%= config.bin %> <%= command.id %> user.email \"you@example.com\"",
-        "<%= config.bin %> <%= command.id %> user.name",
-        "<%= config.bin %> <%= command.id %> user.email"
-      ],
-      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:config",
+      "id": "query-log:summary",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2962,405 +3262,105 @@
         "dist",
         "oclif",
         "commands",
-        "vc",
-        "config.js"
+        "query-log",
+        "summary.js"
       ]
     },
-    "vc:diff": {
-      "aliases": [],
-      "args": {
-        "ref": {
-          "description": "commit, branch, or <ref1>..<ref2> range",
-          "name": "ref"
-        }
-      },
-      "description": "Show changes between commits, the index, or the working tree",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --staged",
-        "<%= config.bin %> <%= command.id %> HEAD~1",
-        "<%= config.bin %> <%= command.id %> main..feature/x",
-        "<%= config.bin %> <%= command.id %> main"
-      ],
-      "flags": {
-        "staged": {
-          "description": "Show staged changes (HEAD vs index)",
-          "name": "staged",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:diff",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "diff.js"
-      ]
-    },
-    "vc:fetch": {
+    "query-log:view": {
       "aliases": [],
       "args": {
-        "remote": {
-          "description": "Remote name (only origin supported)",
-          "name": "remote",
-          "required": false
-        },
-        "branch": {
-          "description": "Branch to fetch",
-          "name": "branch",
+        "id": {
+          "description": "Query log entry ID to view in detail",
+          "name": "id",
           "required": false
         }
       },
-      "description": "Fetch refs from ByteRover cloud",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> origin",
-        "<%= config.bin %> <%= command.id %> origin main"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:fetch",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "fetch.js"
-      ]
-    },
-    "vc": {
-      "aliases": [],
-      "args": {},
-      "description": "Version control commands for the context tree",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --help"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "index.js"
-      ]
-    },
-    "vc:init": {
-      "aliases": [],
-      "args": {},
-      "description": "Initialize ByteRover version control for context tree",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:init",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "init.js"
-      ]
-    },
-    "vc:log": {
-      "aliases": [],
-      "args": {
-        "branch": {
-          "description": "Branch name to show history for",
-          "name": "branch"
-        }
-      },
-      "description": "Show commit history for the context-tree",
+      "description": "View query log history",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> qry-1712345678901",
         "<%= config.bin %> <%= command.id %> --limit 20",
-        "<%= config.bin %> <%= command.id %> main",
-        "<%= config.bin %> <%= command.id %> --all"
+        "<%= config.bin %> <%= command.id %> --status completed",
+        "<%= config.bin %> <%= command.id %> --status completed --status error",
+        "<%= config.bin %> <%= command.id %> --tier 0 --tier 1",
+        "<%= config.bin %> <%= command.id %> --since 1h",
+        "<%= config.bin %> <%= command.id %> --since 2024-01-15",
+        "<%= config.bin %> <%= command.id %> --before 2024-02-01",
+        "<%= config.bin %> <%= command.id %> --detail",
+        "<%= config.bin %> <%= command.id %> --format json"
       ],
       "flags": {
-        "all": {
-          "char": "a",
-          "description": "Show commits from all branches",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "limit": {
-          "description": "Number of commits to show",
-          "name": "limit",
-          "default": 10,
+        "before": {
+          "description": "Show entries started before this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)",
+          "name": "before",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:log",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "log.js"
-      ]
-    },
-    "vc:merge": {
-      "aliases": [],
-      "args": {
-        "branch": {
-          "description": "Branch to merge into the current branch",
-          "name": "branch",
-          "required": false
-        }
-      },
-      "description": "Merge a branch into the current branch",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> feature/my-branch",
-        "<%= config.bin %> <%= command.id %> --abort",
-        "<%= config.bin %> <%= command.id %> --continue",
-        "<%= config.bin %> <%= command.id %> -m \"Custom merge message\" feature/my-branch"
-      ],
-      "flags": {
-        "abort": {
-          "description": "Abort the current merge",
-          "exclusive": [
-            "continue"
-          ],
-          "name": "abort",
-          "allowNo": false,
-          "type": "boolean"
         },
-        "allow-unrelated-histories": {
-          "description": "Allow merging unrelated histories",
-          "name": "allow-unrelated-histories",
+        "detail": {
+          "description": "Show matched docs for each entry",
+          "name": "detail",
           "allowNo": false,
           "type": "boolean"
         },
-        "continue": {
-          "description": "Continue the current merge after resolving conflicts",
-          "exclusive": [
-            "abort"
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
           ],
-          "name": "continue",
-          "allowNo": false,
-          "type": "boolean"
+          "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "Merge commit message",
-          "name": "message",
+        "limit": {
+          "description": "Maximum number of log entries to display",
+          "name": "limit",
+          "default": 10,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:merge",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "merge.js"
-      ]
-    },
-    "vc:pull": {
-      "aliases": [],
-      "args": {
-        "remote": {
-          "description": "Remote name (only origin supported)",
-          "name": "remote",
-          "required": false
         },
-        "branch": {
-          "description": "Branch to pull",
-          "name": "branch",
-          "required": false
-        }
-      },
-      "description": "Pull commits from ByteRover cloud",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> origin main",
-        "<%= config.bin %> <%= command.id %> origin main --allow-unrelated-histories"
-      ],
-      "flags": {
-        "allow-unrelated-histories": {
-          "description": "Allow merging unrelated histories",
-          "name": "allow-unrelated-histories",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:pull",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "pull.js"
-      ]
-    },
-    "vc:push": {
-      "aliases": [],
-      "args": {
-        "remote": {
-          "description": "Remote name (only origin supported)",
-          "name": "remote",
-          "required": false
+        "since": {
+          "description": "Show entries started after this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)",
+          "name": "since",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "branch": {
-          "description": "Branch to push",
-          "name": "branch",
-          "required": false
-        }
-      },
-      "description": "Push commits to ByteRover cloud",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> -u",
-        "<%= config.bin %> <%= command.id %> origin feat/my-branch"
-      ],
-      "flags": {
-        "set-upstream": {
-          "char": "u",
-          "description": "Set upstream tracking branch",
-          "name": "set-upstream",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:push",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "push.js"
-      ]
-    },
-    "vc:reset": {
-      "aliases": [],
-      "args": {},
-      "description": "Unstage files or undo commits",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> notes.md",
-        "<%= config.bin %> <%= command.id %> --soft HEAD~1",
-        "<%= config.bin %> <%= command.id %> --hard HEAD~1",
-        "<%= config.bin %> <%= command.id %> --hard"
-      ],
-      "flags": {
-        "hard": {
-          "description": "Reset HEAD, index, and working tree",
-          "exclusive": [
-            "soft"
+        "status": {
+          "description": "Filter by status (can be repeated). Options: cancelled, completed, error, processing",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "cancelled",
+            "completed",
+            "error",
+            "processing"
           ],
-          "name": "hard",
-          "allowNo": false,
-          "type": "boolean"
+          "type": "option"
         },
-        "soft": {
-          "description": "Reset HEAD only, keep changes staged",
-          "exclusive": [
-            "hard"
+        "tier": {
+          "description": "Filter by resolution tier (can be repeated). Options: 0, 1, 2, 3, 4",
+          "name": "tier",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "0",
+            "1",
+            "2",
+            "3",
+            "4"
           ],
-          "name": "soft",
-          "allowNo": false,
-          "type": "boolean"
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:reset",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": false,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "reset.js"
-      ]
-    },
-    "vc:status": {
-      "aliases": [],
-      "args": {},
-      "description": "Show ByteRover version control status",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:status",
+      "id": "query-log:view",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -3371,8 +3371,8 @@
         "dist",
         "oclif",
         "commands",
-        "vc",
-        "status.js"
+        "query-log",
+        "view.js"
       ]
     },
     "vc:remote:add": {
@@ -3508,5 +3508,5 @@
       ]
     }
   },
-  "version": "3.10.3"
+  "version": "3.12.0"
 }