Add dev and deploy commands to agents CLI

Introduces 'dev' and 'deploy' stub commands to the agents CLI, updates tests for comprehensive coverage of these commands, and adds 'create' as an alias for 'init'. Help output and command descriptions are updated accordingly.

Author: threepointone

.changeset/soft-beds-rescue.md

@@ -4,4 +4,11 @@
 
 Add CLI entry point and tests for agents package
 
-Introduces a new CLI for the agents package using yargs, with 'init' and 'mcp' commands stubbed. Adds CLI test suite and configuration for Vitest, updates package.json to register the CLI binary, and includes related dependencies.
+Introduces a new CLI for the agents package using yargs with the following commands (currently stubs, not yet implemented):
+
+- `init` / `create` - Initialize an agents project
+- `dev` - Start development server
+- `deploy` - Deploy agents to Cloudflare
+- `mcp` - The agents mcp server
+
+Adds CLI test suite with comprehensive coverage for all commands and configurations. Updates package.json to register the CLI binary, adds test scripts for CLI testing, and includes yargs dependencies.

packages/agents/src/cli-tests/cli.test.ts

@@ -58,6 +58,22 @@ describe("agents CLI", () => {
       expect(exitCode).toBe(0);
     });
 
+    it("should execute create alias command", async () => {
+      const cli = createCli(["node", "cli.js", "create"]).exitProcess(false);
+      try {
+        await cli.parse();
+      } catch (error) {
+        // process.exit throws, which is expected
+        if ((error as Error).message === "process.exit(0)") {
+          // This is expected, continue
+        } else {
+          throw error;
+        }
+      }
+      expect(consoleOutput).toContain("agents init: not implemented yet");
+      expect(exitCode).toBe(0);
+    });
+
     it("should show init in help", async () => {
       const cli = createCli(["node", "cli.js", "init", "--help"]);
       try {
@@ -71,6 +87,66 @@ describe("agents CLI", () => {
     });
   });
 
+  describe("dev command", () => {
+    it("should execute dev command", async () => {
+      const cli = createCli(["node", "cli.js", "dev"]).exitProcess(false);
+      try {
+        await cli.parse();
+      } catch (error) {
+        // process.exit throws, which is expected
+        if ((error as Error).message === "process.exit(0)") {
+          // This is expected, continue
+        } else {
+          throw error;
+        }
+      }
+      expect(consoleOutput).toContain("agents dev: not implemented yet");
+      expect(exitCode).toBe(0);
+    });
+
+    it("should show dev in help", async () => {
+      const cli = createCli(["node", "cli.js", "dev", "--help"]);
+      try {
+        await cli.parse();
+      } catch (error) {
+        // process.exit throws, which is expected for help
+        expect((error as Error).message).toBe("process.exit(0)");
+      }
+      const allOutput = [...consoleOutput, ...consoleError].join("\n");
+      expect(allOutput).toContain("Start development server");
+    });
+  });
+
+  describe("deploy command", () => {
+    it("should execute deploy command", async () => {
+      const cli = createCli(["node", "cli.js", "deploy"]).exitProcess(false);
+      try {
+        await cli.parse();
+      } catch (error) {
+        // process.exit throws, which is expected
+        if ((error as Error).message === "process.exit(0)") {
+          // This is expected, continue
+        } else {
+          throw error;
+        }
+      }
+      expect(consoleOutput).toContain("agents deploy: not implemented yet");
+      expect(exitCode).toBe(0);
+    });
+
+    it("should show deploy in help", async () => {
+      const cli = createCli(["node", "cli.js", "deploy", "--help"]);
+      try {
+        await cli.parse();
+      } catch (error) {
+        // process.exit throws, which is expected for help
+        expect((error as Error).message).toBe("process.exit(0)");
+      }
+      const allOutput = [...consoleOutput, ...consoleError].join("\n");
+      expect(allOutput).toContain("Deploy agents to Cloudflare");
+    });
+  });
+
   describe("mcp command", () => {
     it("should execute mcp command", async () => {
       const cli = createCli(["node", "cli.js", "mcp"]).exitProcess(false);
@@ -114,6 +190,8 @@ describe("agents CLI", () => {
       expect(allOutput).toContain("agents");
       expect(allOutput).toContain("Commands:");
       expect(allOutput).toContain("init");
+      expect(allOutput).toContain("dev");
+      expect(allOutput).toContain("deploy");
       expect(allOutput).toContain("mcp");
     });
 

packages/agents/src/cli.ts

@@ -9,14 +9,32 @@ export function createCli(argv = process.argv) {
     .scriptName("agents")
     .usage("$0 <command> [options]")
     .command(
-      "init",
+      ["init", "create"],
       "Initialize an agents project",
       (cmd) => cmd,
       async () => {
         console.log("agents init: not implemented yet");
         process.exit(0);
       }
     )
+    .command(
+      "dev",
+      "Start development server",
+      (cmd) => cmd,
+      async () => {
+        console.log("agents dev: not implemented yet");
+        process.exit(0);
+      }
+    )
+    .command(
+      "deploy",
+      "Deploy agents to Cloudflare",
+      (cmd) => cmd,
+      async () => {
+        console.log("agents deploy: not implemented yet");
+        process.exit(0);
+      }
+    )
     .command(
       "mcp",
       "The agents mcp server",