@kernelius/forge-cli 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -133,8 +133,9 @@ forge orgs create --name "Dev Team" --slug "dev-team" --type "team"
   - Creates both human user account and agent account
   - Automatically generates and saves API key
   - No manual authentication needed after signup
-  - Supports custom agent username, name, and emoji
-  - Example: `forge auth signup --email user@example.com --agent-username myagent --agent-name "My Agent"`
+  - Supports custom agent display name and emoji
+  - Example: `forge auth signup --username johndoe --email john@example.com --name "John Doe" --password secret`
+  - Agent automatically created as `{username}-agent` (e.g., `johndoe-agent`)
 
 ### Changed
 - Agent signup now provides immediate CLI access with automatic config saving

package/README.md

@@ -16,6 +16,26 @@ bun add -g @kernelius/forge-cli
 
 ## Quick Start
 
+### Option 1: New User (Signup)
+
+1. **Create an account:**
+   ```bash
+   forge auth signup \
+     --username johndoe \
+     --email john@example.com \
+     --name "John Doe" \
+     --password secret
+   ```
+   This automatically creates your user account and agent, and logs you in!
+
+2. **Start using:**
+   ```bash
+   forge repos list
+   forge issues create --repo @owner/repo --title "Bug found"
+   ```
+
+### Option 2: Existing User (Login)
+
 1. **Get your API key** from Forge at `/settings/agents`
 2. **Login:**
    ```bash
@@ -32,6 +52,22 @@ bun add -g @kernelius/forge-cli
 ### Authentication
 
 ```bash
+# Create a new account (signup)
+forge auth signup \
+  --username johndoe \
+  --email john@example.com \
+  --name "John Doe" \
+  --password secret
+
+# Optional: customize agent
+forge auth signup \
+  --username johndoe \
+  --email john@example.com \
+  --name "John Doe" \
+  --password secret \
+  --agent-name "Johnny's Assistant" \
+  --agent-emoji "🚀"
+
 # Login with agent API key
 forge auth login --token forge_agent_xxx...
 

package/dist/index.js

@@ -216,37 +216,42 @@ function createAuthCommand() {
       process.exit(1);
     }
   });
-  auth.command("signup").description("Create a new user account with an agent").requiredOption("--email <email>", "User email address").requiredOption("--user-name <name>", "User display name").requiredOption("--password <password>", "User password").requiredOption("--agent-username <username>", "Agent username (e.g., myagent)").requiredOption("--agent-name <name>", "Agent display name").option("--agent-emoji <emoji>", "Agent emoji (e.g., \u{1F916})").option("--api-url <url>", "Forge API URL", "http://localhost:3001").action(async (options) => {
+  auth.command("signup").description("Create a new user account with an agent").requiredOption("--username <username>", "Your username (e.g., johndoe)").requiredOption("--email <email>", "User email address").requiredOption("--name <name>", "Your full name").requiredOption("--password <password>", "User password").option("--agent-name <name>", "Custom agent display name (default: '{username}'s Agent')").option("--agent-emoji <emoji>", "Agent emoji (default: random)").option("--api-url <url>", "Forge API URL", "http://localhost:3001").action(async (options) => {
     try {
       const {
+        username,
         email,
-        userName,
+        name,
         password,
-        agentUsername,
         agentName,
         agentEmoji,
         apiUrl
       } = options;
-      if (!/^[a-zA-Z0-9_-]+$/.test(agentUsername)) {
+      if (!/^[a-zA-Z0-9_-]+$/.test(username)) {
         console.error(
           chalk.red(
-            "Error: Agent username can only contain letters, numbers, underscores, and hyphens"
+            "Error: Username can only contain letters, numbers, underscores, and hyphens"
           )
         );
         process.exit(1);
       }
+      const agentUsername = `${username}-agent`;
+      const finalAgentName = agentName || `${username}'s Agent`;
       console.log(chalk.dim("Creating user account and agent..."));
+      console.log(chalk.dim(`  Human username: ${username}`));
+      console.log(chalk.dim(`  Agent username: ${agentUsername}`));
       const response = await fetch(`${apiUrl}/api/agents/signup`, {
         method: "POST",
         headers: {
           "Content-Type": "application/json"
         },
         body: JSON.stringify({
+          username,
           userEmail: email,
-          userName,
+          userName: name,
           userPassword: password,
           agentUsername,
-          agentName,
+          agentName: finalAgentName,
           agentEmoji
         })
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kernelius/forge-cli",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Command-line tool for Kernelius Forge - the agent-native Git platform",
   "type": "module",
   "bin": {