byterover-cli 1.7.2 → 2.0.0

package/oclif.manifest.json

@@ -1,70 +1,45 @@
 {
   "commands": {
-    "curate": {
+    "debug": {
       "aliases": [],
-      "args": {
-        "context": {
-          "description": "Knowledge context: patterns, decisions, errors, or insights",
-          "name": "context",
-          "required": false
-        }
-      },
-      "description": "Curate context to the context tree (connects to running brv instance)\n\nRequires a running brv instance. Start one with: brv\n\nGood examples:\n- \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"\n- \"API rate limit is 100 req/min per user. Implemented using Redis with sliding window in rateLimiter.ts\"\nBad examples:\n- \"Authentication\" or \"JWT tokens\" (too vague, lacks context)\n- \"Rate limiting\" (no implementation details or file references)",
+      "args": {},
+      "description": "Live monitor for daemon internal state (development only)",
       "examples": [
-        "# Curate context - queues task for background processing",
-        "<%= config.bin %> <%= command.id %> \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"",
-        "",
-        "# Include relevant files for comprehensive context (max 5 files)",
-        "<%= config.bin %> <%= command.id %> \"Authentication middleware validates JWT tokens\" -f src/middleware/auth.ts",
-        "",
-        "# Multiple files",
-        "<%= config.bin %> <%= command.id %> \"JWT authentication implementation\" --files src/auth/jwt.ts --files docs/auth.md",
-        "",
-        "# Folder pack - analyze and curate entire folder",
-        "<%= config.bin %> <%= command.id %> --folder src/auth/",
-        "",
-        "# Folder pack with context",
-        "<%= config.bin %> <%= command.id %> \"Analyze authentication module\" -d src/auth/"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --format json",
+        "<%= config.bin %> <%= command.id %> --once"
       ],
       "flags": {
-        "files": {
-          "char": "f",
-          "description": "Include specific file paths for critical context (max 5 files)",
-          "name": "files",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "folder": {
-          "char": "d",
-          "description": "Folder path to pack and analyze (triggers folder pack flow)",
-          "name": "folder",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "force": {
+          "description": "Kill existing daemon and start fresh",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         },
         "format": {
-          "description": "Output format (text or json)",
+          "char": "f",
+          "description": "Output format",
           "name": "format",
-          "default": "text",
+          "default": "tree",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "text",
+            "tree",
             "json"
           ],
           "type": "option"
         },
-        "headless": {
-          "description": "Run in headless mode (no TTY required, suitable for automation)",
-          "name": "headless",
+        "once": {
+          "description": "Print once and exit (no live monitoring)",
+          "name": "once",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "curate",
+      "id": "debug",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -75,7 +50,7 @@
         "dist",
         "oclif",
         "commands",
-        "curate.js"
+        "debug.js"
       ]
     },
     "hook-prompt-submit": {
@@ -100,30 +75,25 @@
         "hook-prompt-submit.js"
       ]
     },
-    "init": {
+    "login": {
       "aliases": [],
       "args": {},
-      "description": "Initialize a project with ByteRover\n\nSets up ByteRover for the current project by selecting a team and space.\nFor headless mode, you must provide --team and --space (ID or name).",
+      "description": "Authenticate with ByteRover for cloud sync features (optional for local usage)",
       "examples": [
-        "# Interactive initialization",
-        "<%= config.bin %> <%= command.id %>",
-        "",
-        "# Force re-initialization",
-        "<%= config.bin %> <%= command.id %> --force",
+        "<%= config.bin %> <%= command.id %> --api-key <key>",
         "",
-        "# Headless mode with team/space names",
-        "<%= config.bin %> <%= command.id %> --headless --team my-team --space my-space --format json",
-        "",
-        "# Headless mode with team/space IDs",
-        "<%= config.bin %> <%= command.id %> --headless --team team-abc123 --space space-xyz789 --format json"
+        "# JSON output (for automation)",
+        "<%= config.bin %> <%= command.id %> --api-key <key> --format json"
       ],
       "flags": {
-        "force": {
-          "char": "f",
-          "description": "Force re-initialization without confirmation prompt",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
+        "api-key": {
+          "char": "k",
+          "description": "API key for authentication (get yours at https://app.byterover.dev/settings/keys)",
+          "name": "api-key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
         "format": {
           "description": "Output format (text or json)",
@@ -136,60 +106,6 @@
             "json"
           ],
           "type": "option"
-        },
-        "headless": {
-          "description": "Run in headless mode (no TTY required, requires --team and --space)",
-          "name": "headless",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "space": {
-          "description": "Space ID or name (required for headless mode)",
-          "name": "space",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "team": {
-          "description": "Team ID or name (required for headless mode)",
-          "name": "team",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "init",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "init.js"
-      ]
-    },
-    "login": {
-      "aliases": [],
-      "args": {},
-      "description": "Authenticate with ByteRover using an API key",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --api-key <key>"
-      ],
-      "flags": {
-        "api-key": {
-          "char": "k",
-          "description": "API key for authentication (get yours at https://app.byterover.dev/settings/keys)",
-          "name": "api-key",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -233,7 +149,7 @@
     "mcp": {
       "aliases": [],
       "args": {},
-      "description": "Start MCP server for coding agent integration\n\nConnects to a running brv instance via Socket.IO.\nRequires: brv running in another terminal.\n\nExposes tools:\n- brv-query: Query the context tree\n- brv-curate: Curate context to the tree",
+      "description": "Start MCP server for coding agent integration\n\nExposes tools:\n- brv-query: Query the context tree\n- brv-curate: Curate context to the tree",
       "examples": [
         "# Start MCP server (typically called by coding agents)",
         "<%= config.bin %> <%= command.id %>"
@@ -266,9 +182,7 @@
         "",
         "# Pull from specific branch",
         "<%= config.bin %> <%= command.id %> --branch feature-branch",
-        "",
-        "# Headless mode with JSON output",
-        "<%= config.bin %> <%= command.id %> --headless --format json"
+        ""
       ],
       "flags": {
         "branch": {
@@ -291,12 +205,6 @@
             "json"
           ],
           "type": "option"
-        },
-        "headless": {
-          "description": "Run in headless mode (no TTY required, suitable for automation)",
-          "name": "headless",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -324,13 +232,7 @@
         "<%= config.bin %> <%= command.id %>",
         "",
         "# Push to specific branch",
-        "<%= config.bin %> <%= command.id %> --branch feature-branch",
-        "",
-        "# Skip confirmation prompt",
-        "<%= config.bin %> <%= command.id %> -y",
-        "",
-        "# Headless mode with JSON output",
-        "<%= config.bin %> <%= command.id %> --headless --format json -y"
+        "<%= config.bin %> <%= command.id %> --branch feature-branch"
       ],
       "flags": {
         "branch": {
@@ -353,19 +255,6 @@
             "json"
           ],
           "type": "option"
-        },
-        "headless": {
-          "description": "Run in headless mode (no TTY required, suitable for automation)",
-          "name": "headless",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Skip confirmation prompt",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -393,14 +282,14 @@
           "required": true
         }
       },
-      "description": "Query and retrieve information from the context tree (connects to running brv instance)\n\nRequires a running brv instance. Start one with: brv\n\nGood:\n- \"How is user authentication implemented?\"\n- \"What are the API rate limits and where are they enforced?\"\nBad:\n- \"auth\" or \"authentication\" (too vague, not a question)\n- \"show me code\" (not specific about what information is needed)",
+      "description": "Query and retrieve information from the context tree\n\nGood:\n- \"How is user authentication implemented?\"\n- \"What are the API rate limits and where are they enforced?\"\nBad:\n- \"auth\" or \"authentication\" (too vague, not a question)\n- \"show me code\" (not specific about what information is needed)",
       "examples": [
         "# Ask questions about patterns, decisions, or implementation details",
         "<%= config.bin %> <%= command.id %> What are the coding standards?",
         "<%= config.bin %> <%= command.id %> How is authentication implemented?",
         "",
-        "# Headless mode with JSON output (for automation)",
-        "<%= config.bin %> <%= command.id %> \"How does auth work?\" --headless --format json"
+        "# JSON output (for automation)",
+        "<%= config.bin %> <%= command.id %> \"How does auth work?\" --format json"
       ],
       "flags": {
         "format": {
@@ -414,12 +303,6 @@
             "json"
           ],
           "type": "option"
-        },
-        "headless": {
-          "description": "Run in headless mode (no TTY required, suitable for automation)",
-          "name": "headless",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -438,27 +321,36 @@
         "query.js"
       ]
     },
+    "restart": {
+      "aliases": [],
+      "args": {},
+      "description": "Restart ByteRover — stop everything and start fresh.\n\nRun this when ByteRover is unresponsive, stuck, or after installing an update.\nAll open sessions and background processes are stopped before the fresh start.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "restart",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "restart.js"
+      ]
+    },
     "status": {
       "aliases": [],
-      "args": {
-        "directory": {
-          "description": "Project directory (defaults to current directory)",
-          "name": "directory",
-          "required": false
-        }
-      },
+      "args": {},
       "description": "Show CLI status and project information. Display local context tree managed by ByteRover CLI",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "# Check status after login (in REPL):",
-        "/login",
-        "/status",
-        "",
-        "# Verify project initialization (in REPL):",
-        "/init",
-        "/status",
-        "",
-        "<%= config.bin %> <%= command.id %> /path/to/project",
         "<%= config.bin %> <%= command.id %> --format json"
       ],
       "flags": {
@@ -474,12 +366,6 @@
             "json"
           ],
           "type": "option"
-        },
-        "headless": {
-          "description": "Run in headless mode (no TTY required, suitable for automation)",
-          "name": "headless",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -497,7 +383,1165 @@
         "commands",
         "status.js"
       ]
+    },
+    "connectors": {
+      "aliases": [],
+      "args": {},
+      "description": "List installed agent connectors",
+      "examples": [
+        "<%= config.bin %> connectors",
+        "<%= config.bin %> connectors --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": "connectors",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "connectors",
+        "index.js"
+      ]
+    },
+    "connectors:install": {
+      "aliases": [],
+      "args": {
+        "agent": {
+          "description": "Agent name to install connector for (e.g., \"Claude Code\", \"Cursor\")",
+          "name": "agent",
+          "required": true
+        }
+      },
+      "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",
+      "examples": [
+        "<%= config.bin %> connectors install \"Claude Code\"",
+        "<%= config.bin %> connectors install \"Claude Code\" --type mcp",
+        "<%= config.bin %> connectors install Cursor --type rules"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "type": {
+          "char": "t",
+          "description": "Connector type (rules, hook, mcp, skill). Defaults to agent's recommended type.",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "rules",
+            "hook",
+            "mcp",
+            "skill"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "connectors:install",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "connectors",
+        "install.js"
+      ]
+    },
+    "connectors:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List installed agent connectors",
+      "examples": [
+        "<%= config.bin %> connectors list",
+        "<%= config.bin %> connectors 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": "connectors:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "connectors",
+        "list.js"
+      ]
+    },
+    "curate": {
+      "aliases": [],
+      "args": {
+        "context": {
+          "description": "Knowledge context: patterns, decisions, errors, or insights",
+          "name": "context",
+          "required": false
+        }
+      },
+      "description": "Curate context to the context tree\n\nGood examples:\n- \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"\n- \"API rate limit is 100 req/min per user. Implemented using Redis with sliding window in rateLimiter.ts\"\nBad examples:\n- \"Authentication\" or \"JWT tokens\" (too vague, lacks context)\n- \"Rate limiting\" (no implementation details or file references)",
+      "examples": [
+        "# Curate context - queues task for background processing",
+        "<%= config.bin %> <%= command.id %> \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"",
+        "",
+        "# Include relevant files for comprehensive context (max 5 files)",
+        "<%= config.bin %> <%= command.id %> \"Authentication middleware validates JWT tokens\" -f src/middleware/auth.ts",
+        "",
+        "# Multiple files",
+        "<%= config.bin %> <%= command.id %> \"JWT authentication implementation\" --files src/auth/jwt.ts --files docs/auth.md",
+        "",
+        "# Folder pack - analyze and curate entire folder",
+        "<%= config.bin %> <%= command.id %> --folder src/auth/",
+        "",
+        "# Folder pack with context",
+        "<%= config.bin %> <%= command.id %> \"Analyze authentication module\" -d src/auth/",
+        "",
+        "# View curate history",
+        "<%= config.bin %> curate view",
+        "<%= config.bin %> curate view --status completed --since 1h"
+      ],
+      "flags": {
+        "detach": {
+          "description": "Queue task and exit without waiting for completion",
+          "name": "detach",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "files": {
+          "char": "f",
+          "description": "Include specific file paths for critical context (max 5 files)",
+          "name": "files",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "folder": {
+          "char": "d",
+          "description": "Folder path to pack and analyze (triggers folder pack flow)",
+          "name": "folder",
+          "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": "curate",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "curate",
+        "index.js"
+      ]
+    },
+    "curate:view": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Log entry ID to view in detail",
+          "name": "id",
+          "required": false
+        }
+      },
+      "description": "View curate history",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> cur-1739700001000",
+        "<%= config.bin %> <%= command.id %> --limit 20",
+        "<%= config.bin %> <%= command.id %> --status completed",
+        "<%= config.bin %> <%= command.id %> --status completed --status error",
+        "<%= 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": {
+        "before": {
+          "description": "Show entries started before this time (ISO date or relative: 1h, 24h, 7d, 2w)",
+          "name": "before",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "detail": {
+          "description": "Show operations for each entry in list view",
+          "name": "detail",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "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: 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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "curate:view",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "curate",
+        "view.js"
+      ]
+    },
+    "hub": {
+      "aliases": [],
+      "args": {},
+      "description": "Browse and manage skills & bundles registry",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hub",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "hub",
+        "index.js"
+      ]
+    },
+    "hub:install": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Entry ID to install",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Install a skill or bundle from the hub",
+      "examples": [
+        "<%= config.bin %> hub install byterover-review --agent \"Claude Code\"",
+        "<%= config.bin %> hub install typescript-kickstart",
+        "<%= config.bin %> hub install byterover-review --registry myco"
+      ],
+      "flags": {
+        "agent": {
+          "char": "a",
+          "description": "Target agent for skill install",
+          "name": "agent",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Amp",
+            "Antigravity",
+            "Auggie CLI",
+            "Claude Code",
+            "Codex",
+            "Cursor",
+            "Gemini CLI",
+            "Github Copilot",
+            "Junie",
+            "Kilo Code",
+            "Kiro",
+            "OpenClaw",
+            "OpenCode",
+            "Qoder",
+            "Roo Code",
+            "Trae.ai",
+            "Warp",
+            "Windsurf"
+          ],
+          "type": "option"
+        },
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "registry": {
+          "char": "r",
+          "description": "Registry to install from (when ID exists in multiple registries)",
+          "name": "registry",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "char": "s",
+          "description": "Install scope for skills (global: home directory, project: current project)",
+          "name": "scope",
+          "default": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "global",
+            "project"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hub:install",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "hub",
+        "install.js"
+      ]
+    },
+    "hub:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List available skills & bundles from the hub",
+      "examples": [
+        "<%= config.bin %> hub list",
+        "<%= config.bin %> hub list --format json"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hub:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "hub",
+        "list.js"
+      ]
+    },
+    "model": {
+      "aliases": [],
+      "args": {},
+      "description": "Show the active model",
+      "examples": [
+        "<%= config.bin %> model",
+        "<%= config.bin %> model --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": "model",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "model",
+        "index.js"
+      ]
+    },
+    "model:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List available models from all connected providers",
+      "examples": [
+        "<%= config.bin %> model list",
+        "<%= config.bin %> model list --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "provider": {
+          "char": "p",
+          "description": "Only list models for a specific provider",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "model:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "model",
+        "list.js"
+      ]
+    },
+    "model:switch": {
+      "aliases": [],
+      "args": {
+        "model": {
+          "description": "Model ID to switch to (e.g., claude-sonnet-4-5, gpt-4.1)",
+          "name": "model",
+          "required": true
+        }
+      },
+      "description": "Switch the active model",
+      "examples": [
+        "<%= config.bin %> model switch claude-sonnet-4-5",
+        "<%= config.bin %> model switch gpt-4.1 --provider openai",
+        "<%= config.bin %> model switch claude-sonnet-4-5 --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "provider": {
+          "char": "p",
+          "description": "Provider ID (defaults to active provider)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "model:switch",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "model",
+        "switch.js"
+      ]
+    },
+    "providers:connect": {
+      "aliases": [],
+      "args": {
+        "provider": {
+          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter)",
+          "name": "provider",
+          "required": true
+        }
+      },
+      "description": "Connect or switch to an LLM provider",
+      "examples": [
+        "<%= config.bin %> providers connect anthropic --api-key sk-xxx",
+        "<%= config.bin %> providers connect openai --api-key sk-xxx --model gpt-4.1",
+        "<%= config.bin %> providers connect byterover",
+        "<%= config.bin %> providers connect openai-compatible --base-url http://localhost:11434/v1",
+        "<%= config.bin %> providers connect openai-compatible --base-url http://localhost:11434/v1 --api-key sk-xxx --model llama3",
+        "<%= config.bin %> providers connect google-vertex --credential-file /path/to/service-account.json"
+      ],
+      "flags": {
+        "api-key": {
+          "char": "k",
+          "description": "API key for the provider",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "char": "b",
+          "description": "Base URL for OpenAI-compatible providers (e.g., http://localhost:11434/v1)",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "credential-file": {
+          "char": "f",
+          "description": "Path to service account JSON key file (for Google Vertex AI)",
+          "name": "credential-file",
+          "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"
+        }
+      },
+      "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"
+      ]
+    },
+    "space:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all teams and spaces",
+      "examples": [
+        "<%= config.bin %> space list",
+        "<%= config.bin %> space list --format json"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "space:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "space",
+        "list.js"
+      ]
+    },
+    "space:switch": {
+      "aliases": [],
+      "args": {},
+      "description": "Switch to a different space",
+      "examples": [
+        "<%= config.bin %> space switch --team acme --name my-space",
+        "<%= config.bin %> space switch --team acme --name my-space --format json"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "Name of the space to switch to",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "team": {
+          "char": "t",
+          "description": "Team name",
+          "name": "team",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "space:switch",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "space",
+        "switch.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"
+        },
+        "url": {
+          "char": "u",
+          "description": "Registry URL",
+          "name": "url",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hub:registry:add",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "hub",
+        "registry",
+        "add.js"
+      ]
+    },
+    "hub:registry": {
+      "aliases": [],
+      "args": {},
+      "description": "Manage hub registries",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hub:registry",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "hub",
+        "registry",
+        "index.js"
+      ]
+    },
+    "hub:registry:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List configured hub registries",
+      "examples": [
+        "<%= config.bin %> hub registry list",
+        "<%= config.bin %> hub registry list --format json"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hub:registry:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "hub",
+        "registry",
+        "list.js"
+      ]
+    },
+    "hub:registry:remove": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Registry name to remove",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Remove a hub registry",
+      "examples": [
+        "<%= config.bin %> hub registry remove myco"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hub:registry:remove",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "hub",
+        "registry",
+        "remove.js"
+      ]
     }
   },
-  "version": "1.7.2"
+  "version": "2.0.0"
 }