@kernelius/forge-cli 0.3.2 → 0.3.4

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/SKILL.md

@@ -40,7 +40,18 @@ Before using any forge commands, ensure the user is authenticated:
 forge auth whoami
 ```
 
-If not authenticated, the user needs to:
+If not authenticated, the user can either:
+
+**Option 1: Create a new account (signup)**
+```bash
+forge auth signup \
+  --username johndoe \
+  --email john@example.com \
+  --name "John Doe" \
+  --password secret
+```
+
+**Option 2: Login with existing API key**
 1. Get an agent API key from Forge at `/settings/agents`
 2. Login with: `forge auth login --token forge_agent_xxx...`
 
@@ -106,6 +117,24 @@ forge issues close --repo @owner/repo --number 42
 forge issues comment --repo @owner/repo --number 42 --body "This is fixed now"
 ```
 
+**List comments on an issue:**
+
+```bash
+forge issues comments --repo @owner/repo --number 42
+```
+
+**Reopen an issue:**
+
+```bash
+forge issues reopen --repo @owner/repo --number 42
+```
+
+**Edit an issue:**
+
+```bash
+forge issues edit --repo @owner/repo --number 42 --title "New title" --body "Updated description"
+```
+
 ## Pull Requests
 
 **List pull requests:**
@@ -148,6 +177,50 @@ forge prs close --repo @owner/repo --number 10
 forge prs comment --repo @owner/repo --number 10 --body "Looks good to me!"
 ```
 
+**Submit a review:**
+
+```bash
+# Approve a PR
+forge prs review --repo @owner/repo --number 10 --state approve --body "LGTM!"
+
+# Request changes
+forge prs review --repo @owner/repo --number 10 --state request_changes --body "Please fix X"
+```
+
+**View PR diff:**
+
+```bash
+forge prs diff --repo @owner/repo --number 10
+```
+
+**List commits in a PR:**
+
+```bash
+forge prs commits --repo @owner/repo --number 10
+```
+
+## Templates
+
+**List available templates:**
+
+```bash
+forge templates list
+# Filter by organization type:
+forge templates list --org-type healthcare
+```
+
+**View template details:**
+
+```bash
+forge templates view patient-record
+```
+
+**Create repository from template:**
+
+```bash
+forge repos create --name my-patient-repo --template patient-record --visibility private
+```
+
 ## Important Notes
 
 - **Always specify `--repo @owner/repo`** when working with issues or PRs

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
         })
       });
@@ -1044,9 +1049,10 @@ function createIssuesCommand() {
   issues.command("labels").description("List repository labels").requiredOption("--repo <repo>", "Repository (@owner/name)").action(async (options) => {
     try {
       const [ownerIdentifier, name] = parseRepoArg2(options.repo);
-      const labels = await apiGet(
+      const result = await apiGet(
         `/api/repositories/${ownerIdentifier}/${name}/labels`
       );
+      const labels = result.labels || [];
       if (labels.length === 0) {
         console.log(chalk4.yellow("No labels found"));
         return;
@@ -1364,7 +1370,8 @@ function createPrsCommand() {
       const pr = await apiGet(
         `/api/repositories/${ownerIdentifier}/${name}/pulls/${options.number}`
       );
-      const reviews = await apiGet(`/api/pulls/${pr.id}/reviews`);
+      const result = await apiGet(`/api/pulls/${pr.id}/reviews`);
+      const reviews = result.reviews || [];
       if (reviews.length === 0) {
         console.log(chalk5.yellow("No reviews found"));
         return;
@@ -1398,7 +1405,8 @@ function createPrsCommand() {
       const pr = await apiGet(
         `/api/repositories/${ownerIdentifier}/${name}/pulls/${options.number}`
       );
-      const commits = await apiGet(`/api/pulls/${pr.id}/commits`);
+      const result = await apiGet(`/api/pulls/${pr.id}/commits`);
+      const commits = result.commits || [];
       if (commits.length === 0) {
         console.log(chalk5.yellow("No commits found"));
         return;
@@ -1541,7 +1549,8 @@ function createOrgsCommand() {
   });
   orgs.command("members").description("List organization members").argument("<slug>", "Organization slug").action(async (slug) => {
     try {
-      const members = await apiGet(`/api/organizations/${slug}/members`);
+      const result = await apiGet(`/api/orgs/${slug}/members`);
+      const members = result.members || [];
       if (members.length === 0) {
         console.log(chalk6.yellow("No members found"));
         return;
@@ -1559,7 +1568,7 @@ function createOrgsCommand() {
   });
   orgs.command("member-add").description("Add a member to organization").argument("<slug>", "Organization slug").argument("<username>", "Username to add").option("--role <role>", "Member role (owner/admin/member)", "member").action(async (slug, username, options) => {
     try {
-      await apiPost(`/api/organizations/${slug}/members`, {
+      await apiPost(`/api/orgs/${slug}/members`, {
         username,
         role: options.role
       });
@@ -1571,7 +1580,7 @@ function createOrgsCommand() {
   });
   orgs.command("member-remove").description("Remove a member from organization").argument("<slug>", "Organization slug").argument("<username>", "Username to remove").action(async (slug, username) => {
     try {
-      await apiDelete(`/api/organizations/${slug}/members/${username}`);
+      await apiDelete(`/api/orgs/${slug}/members/${username}`);
       console.log(chalk6.green(`\u2713 Removed @${username} from @${slug}`));
     } catch (error) {
       console.error(chalk6.red(`Error: ${error.message}`));
@@ -1580,7 +1589,8 @@ function createOrgsCommand() {
   });
   orgs.command("teams").description("List organization teams").argument("<slug>", "Organization slug").action(async (slug) => {
     try {
-      const teams = await apiGet(`/api/organizations/${slug}/teams`);
+      const result = await apiGet(`/api/orgs/${slug}/teams`);
+      const teams = result.teams || [];
       if (teams.length === 0) {
         console.log(chalk6.yellow("No teams found"));
         return;
@@ -1600,7 +1610,7 @@ function createOrgsCommand() {
   });
   orgs.command("team-create").description("Create a team in organization").argument("<slug>", "Organization slug").requiredOption("--name <name>", "Team name").option("--description <desc>", "Team description").action(async (slug, options) => {
     try {
-      const team = await apiPost(`/api/organizations/${slug}/teams`, {
+      const team = await apiPost(`/api/orgs/${slug}/teams`, {
         name: options.name,
         description: options.description
       });
@@ -1612,9 +1622,10 @@ function createOrgsCommand() {
   });
   orgs.command("team-members").description("List team members").argument("<slug>", "Organization slug").argument("<team>", "Team name").action(async (slug, team) => {
     try {
-      const members = await apiGet(
-        `/api/organizations/${slug}/teams/${team}/members`
+      const result = await apiGet(
+        `/api/orgs/${slug}/teams/${team}/members`
       );
+      const members = result.members || [];
       if (members.length === 0) {
         console.log(chalk6.yellow("No team members found"));
         return;
@@ -1632,7 +1643,7 @@ function createOrgsCommand() {
   orgs.command("team-add-member").description("Add a member to team").argument("<slug>", "Organization slug").argument("<team>", "Team name").argument("<username>", "Username to add").action(async (slug, team, username) => {
     try {
       await apiPost(
-        `/api/organizations/${slug}/teams/${team}/members`,
+        `/api/orgs/${slug}/teams/${team}/members`,
         {
           username
         }
@@ -1646,7 +1657,7 @@ function createOrgsCommand() {
   orgs.command("team-remove-member").description("Remove a member from team").argument("<slug>", "Organization slug").argument("<team>", "Team name").argument("<username>", "Username to remove").action(async (slug, team, username) => {
     try {
       await apiDelete(
-        `/api/organizations/${slug}/teams/${team}/members/${username}`
+        `/api/orgs/${slug}/teams/${team}/members/${username}`
       );
       console.log(chalk6.green(`\u2713 Removed @${username} from team ${team}`));
     } catch (error) {

package/package.json

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