@botbuddy/cli 1.1.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbuddy/cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "BotBuddy — Swarm coordination CLI for multi-agent workflows",
   "type": "module",
   "bin": {

package/src/commands.mjs

@@ -4,16 +4,18 @@ import { runBridge } from "./codex-bridge.mjs";
 import { loadConfig, getConfig, clearConfig, saveConfig, getConfigPath } from "./config.mjs";
 import { green, red, cyan, dim, bold, die } from "./utils.mjs";
 
-const VERSION = "1.0.0";
+const VERSION = "1.1.0";
 
-export function run(argv) {
+export async function run(argv) {
   loadConfig();
   const [command, ...args] = argv;
 
   switch (command) {
+    case "start": return cmdStart(args);
     case "login": return doLogin();
     case "logout": return cmdLogout();
     case "status": return cmdStatus();
+    // Agent-only commands (used by MCP agents, not humans)
     case "register": return cmdRegister(args);
     case "heartbeat": return cmdHeartbeat(args);
     case "lock": return cmdLock(args);
@@ -39,52 +41,39 @@ function cmdHelp() {
   console.log(`${bold("botbuddy")} ${dim(`v${VERSION}`)} — Swarm coordination CLI
 
 ${bold("USAGE")}
-  botbuddy <command> [options]
+  botbuddy start             Start BotBuddy (login + codex server + bridge)
+
+${bold("OPTIONS")}
+  start [options]
+    -p, --port <port>        WebSocket port (default: 4500)
+    -r, --repo <path>        Repository path (default: cwd)
+    -m, --model <model>      Default model (default: gpt-5.4)
+    --no-server              Don't auto-start codex app-server
 
 ${bold("AUTH")}
-  login                    Authenticate via OAuth (PKCE)
-  logout                   Remove saved credentials
-  status                   Show current auth status
-
-${bold("AGENTS")}
-  register <name> [type]   Register a new agent (type: codex|claude|gpt|custom)
-  agents                   List all agents
-  heartbeat [task]         Send a heartbeat
-
-${bold("RESOURCES")}
-  lock <name> <type>       Acquire a single lock (type: port|mcp_server|file|...)
-  locks [options]          Batch-acquire resources (auto-assigns free ones)
-    -p, --port [type]      Request a port (frontend|backend, default: frontend)
-    -m, --mcp              Request an MCP server slot
-    -t, --ticket <id>      Ticket ID (shared across all locks)
-    --pr <id>              PR ID (shared across all locks)
-  unlock <name>            Release a lock
-  resources                List all resources and locks
-
-${bold("TASKS")}
-  task create <title> [-d description] [-p priority]
-  task claim <id>          Claim a pending task
-  task done <id>           Mark a task as done
-  tasks                    List all tasks
-
-${bold("SWARM")}
-  hours                    Get current working hours
-  hours derive             Derive working hours from activity
-  hours set <json>         Set working hours manually
-
-${bold("BROWSE")}
-  browse agents|tasks|resources|activity|settings
-
-${bold("CODEX")}
-  codex bridge [options]   Start Codex app-server + bridge (single command)
-    -p, --port <port>      WebSocket port (default: 4500)
-    -r, --repo <path>      Repository path (default: cwd)
-    -m, --model <model>    Default model (default: gpt-5.4)
-    --no-server            Don't auto-start app-server (if already running)
+  login                      Re-authenticate via OAuth
+  logout                     Remove saved credentials
+  status                     Show current auth status
 
 ${bold("OTHER")}
-  help                     Show this help
-  version                  Show version`);
+  help                       Show this help
+  version                    Show version`);
+}
+
+async function cmdStart(args) {
+  const cfg = getConfig();
+
+  // Auto-login if not authenticated
+  if (!cfg.access_token && !cfg.api_key) {
+    console.log(dim("→ No credentials found. Starting login...\n"));
+    await doLogin();
+  } else if (cfg.token_expires_at && cfg.token_expires_at <= Date.now()) {
+    console.log(dim("→ Token expired. Re-authenticating...\n"));
+    await doLogin();
+  }
+
+  // Start the bridge (which auto-starts codex app-server)
+  return runBridge(args);
 }
 
 function cmdStatus() {
@@ -96,7 +85,7 @@ function cmdStatus() {
     if (cfg.token_expires_at) {
       const remaining = cfg.token_expires_at - Date.now();
       if (remaining <= 0) {
-        console.log(`  Token: ${red("EXPIRED")} — run ${cyan("botbuddy login")}`);
+        console.log(`  Token: ${red("EXPIRED")} — run ${cyan("botbuddy start")}`);
       } else {
         const mins = Math.round(remaining / 60000);
         const label = mins > 60 ? `${Math.round(mins / 60)}h ${mins % 60}m` : `${mins}m`;
@@ -109,7 +98,7 @@ function cmdStatus() {
     if (cfg.agent_name) console.log(`  Agent: ${cyan(cfg.agent_name)}`);
   } else {
     console.log(`${red("✗")} Not authenticated`);
-    console.log(`  Run: ${cyan("botbuddy login")}`);
+    console.log(`  Run: ${cyan("botbuddy start")}`);
   }
 }
 
@@ -214,12 +203,7 @@ function cmdBrowse(args) {
 }
 
 function cmdCodex(args) {
-  const sub = args[0];
-  if (!sub) die("Usage: botbuddy codex <bridge> [options]");
-  switch (sub) {
-    case "bridge":
-      return runBridge(args.slice(1));
-    default:
-      die(`Unknown codex subcommand: ${sub}. Try: botbuddy codex bridge`);
-  }
+  // Legacy alias — redirect to start
+  console.log(dim("Note: 'botbuddy codex bridge' is now 'botbuddy start'\n"));
+  return runBridge(args.slice(1));
 }