refactor: migrate CLI to commander for structured argument parsing

Replace manual argv parsing with commander.js to provide proper
subcommand handling, automatic help generation, and conventional
-v/--version flags. Adds trpc-cli as a dependency (likely for future
oRPC CLI tooling).

Author: ThomasK33

bun.lock

@@ -30,6 +30,7 @@
         "ai": "^5.0.101",
         "ai-tokenizer": "^1.0.4",
         "chalk": "^5.6.2",
+        "commander": "^14.0.2",
         "cors": "^2.8.5",
         "crc-32": "^1.2.2",
         "diff": "^8.0.2",
@@ -51,6 +52,7 @@
         "shescape": "^2.1.6",
         "source-map-support": "^0.5.21",
         "streamdown": "^1.4.0",
+        "trpc-cli": "^0.12.1",
         "turndown": "^7.2.2",
         "undici": "^7.16.0",
         "write-file-atomic": "^6.0.0",
@@ -3401,6 +3403,8 @@
 
     "trough": ["trough@2.2.0", "", {}, "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw=="],
 
+    "trpc-cli": ["trpc-cli@0.12.1", "", { "dependencies": { "commander": "^14.0.0" }, "peerDependencies": { "@orpc/server": "^1.0.0", "@trpc/server": "^10.45.2 || ^11.0.1", "@valibot/to-json-schema": "^1.1.0", "effect": "^3.14.2 || ^4.0.0", "valibot": "^1.1.0", "zod": "^3.24.0 || ^4.0.0" }, "optionalPeers": ["@orpc/server", "@trpc/server", "@valibot/to-json-schema", "effect", "valibot", "zod"], "bin": { "trpc-cli": "dist/bin.js" } }, "sha512-/D/mIQf3tUrS7ZKJZ1gmSPJn2psAABJfkC5Eevm55SZ4s6KwANOUNlwhAGXN9HT4VSJVfoF2jettevE9vHPQlg=="],
+
     "truncate-utf8-bytes": ["truncate-utf8-bytes@1.0.2", "", { "dependencies": { "utf8-byte-length": "^1.0.1" } }, "sha512-95Pu1QXQvruGEhv62XCMO3Mm90GscOCClvrIUwCM0PYOXK3kaF3l3sIHxx71ThJfcbM2O5Au6SO3AWCSEfW4mQ=="],
 
     "ts-api-utils": ["ts-api-utils@2.1.0", "", { "peerDependencies": { "typescript": ">=4.8.4" } }, "sha512-CUgTZL1irw8u29bzrOD/nH85jqyc74D6SshFgujOIA7osm2Rz7dYH77agkx7H4FBNxDq7Cjf+IjaX/8zwFW+ZQ=="],

package.json

@@ -71,6 +71,7 @@
     "ai": "^5.0.101",
     "ai-tokenizer": "^1.0.4",
     "chalk": "^5.6.2",
+    "commander": "^14.0.2",
     "cors": "^2.8.5",
     "crc-32": "^1.2.2",
     "diff": "^8.0.2",
@@ -92,6 +93,7 @@
     "shescape": "^2.1.6",
     "source-map-support": "^0.5.21",
     "streamdown": "^1.4.0",
+    "trpc-cli": "^0.12.1",
     "turndown": "^7.2.2",
     "undici": "^7.16.0",
     "write-file-atomic": "^6.0.0",

src/cli/index.ts

@@ -1,19 +1,37 @@
 #!/usr/bin/env node
 
-const subcommand = process.argv.length > 2 ? process.argv[2] : null;
+import { Command } from "commander";
+import { VERSION } from "../version";
 
-if (subcommand === "server") {
-  // Remove 'server' from args since main-server doesn't expect it as a positional argument.
-  process.argv.splice(2, 1);
-  // eslint-disable-next-line @typescript-eslint/no-require-imports
-  require("./server");
-} else if (subcommand === "version") {
-  // eslint-disable-next-line @typescript-eslint/no-require-imports
-  const { VERSION } = require("../version") as {
-    VERSION: { git_describe: string; git_commit: string };
-  };
-  console.log(`mux ${VERSION.git_describe} (${VERSION.git_commit})`);
-} else {
+const program = new Command();
+
+program
+  .name("mux")
+  .description("mux - coder multiplexer")
+  .version(`mux ${VERSION.git_describe} (${VERSION.git_commit})`, "-v, --version");
+
+program
+  .command("server")
+  .description("Start the HTTP/WebSocket oRPC server")
+  .allowUnknownOption() // server.ts handles its own options via commander
+  .action(() => {
+    // Remove 'server' from args since server.ts has its own commander instance
+    process.argv.splice(2, 1);
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    require("./server");
+  });
+
+program
+  .command("version")
+  .description("Show version information")
+  .action(() => {
+    console.log(`mux ${VERSION.git_describe} (${VERSION.git_commit})`);
+  });
+
+// Default action: launch desktop app when no subcommand given
+program.action(() => {
   // eslint-disable-next-line @typescript-eslint/no-require-imports
   require("../desktop/main");
-}
+});
+
+program.parse();