@kendoo.agentdesk/agentdesk 0.3.1 → 0.4.0

package/README.md

@@ -42,17 +42,17 @@ This detects your project, asks which task tracker you use (Linear, Jira, GitHub
 
 ### 4. Run a team session
 
-With a task tracker:
+Work on an existing task:
 
 ```bash
 agentdesk team KEN-517
-agentdesk team BUG-42 -d "Fix the checkout total calculation"
 ```
 
-Without a tracker — pass requirements directly:
+Or just describe what you want — a task is created automatically:
 
 ```bash
-agentdesk team add-auth -d "Add Google OAuth to the login page"
+agentdesk team -d "Fix the checkout total calculation"
+agentdesk team -d "Add Google OAuth to the login page"
 ```
 
 Open [agentdesk.live](https://agentdesk.live) to watch the session live.
@@ -102,8 +102,8 @@ AgentDesk also auto-discovers agents from `.claude/agents/`, `.claude/commands/`
 agentdesk login                        Sign in to AgentDesk
 agentdesk logout                       Sign out and remove credentials
 agentdesk init                         Set up project and configure tracker
-agentdesk team <TASK-ID>               Run a team session on a task
-agentdesk team <TASK-ID> -d "..."      Run with a task description
+agentdesk team <TASK-ID>               Run a team session on an existing task
+agentdesk team -d "..."                Describe what you want — task created automatically
 ```
 
 ### Options

package/bin/agentdesk.mjs

@@ -18,22 +18,25 @@ if (!command || command === "help" || command === "--help") {
     agentdesk login                        Sign in to AgentDesk
     agentdesk logout                       Sign out and remove credentials
     agentdesk init                         Set up project and configure tracker
-    agentdesk team <TASK-ID>               Run a team session on a task
-    agentdesk team <TASK-ID> -d "..."      Run with a task description
+    agentdesk team <TASK-ID>               Run a team session on an existing task
+    agentdesk team -d "..."                Create a task and run a session
 
   Options:
     --description, -d    Task description or requirements
     --cwd                Working directory (defaults to current)
 
-  Task trackers:
-    agentdesk init configures your tracker (Linear, Jira, GitHub Issues).
-    Without a tracker, pass requirements directly:
-      agentdesk team my-feature -d "Add dark mode support"
+  How it works:
+    With a tracker (Linear, Jira, GitHub Issues):
+      agentdesk team KEN-517               Work on an existing task
+      agentdesk team -d "Fix login bug"    Create a new task, then work on it
+
+    Without a tracker:
+      agentdesk team -d "Add dark mode"    Describe what you want
 
   Examples:
     agentdesk team KEN-517
-    agentdesk team BUG-42 -d "Fix the checkout total calculation"
-    agentdesk team add-auth -d "Add Google OAuth to the login page"
+    agentdesk team -d "Fix the checkout total calculation"
+    agentdesk team -d "Add Google OAuth to the login page"
 
   Dashboard: https://agentdesk.live
 `);
@@ -56,23 +59,28 @@ else if (command === "init") {
 }
 
 else if (command === "team") {
-  const taskId = args[1];
-  if (!taskId) {
-    console.error("Usage: agentdesk team <TASK-ID>");
-    process.exit(1);
-  }
-
-  // Parse options
+  // Parse options first to find -d and --cwd
   let description = "";
   let cwd = process.cwd();
-  for (let i = 2; i < args.length; i++) {
-    if ((args[i] === "--description" || args[i] === "-d") && args[i + 1]) {
-      description = args[++i];
-    } else if (args[i] === "--cwd" && args[i + 1]) {
-      cwd = args[++i];
+  let taskId = null;
+  const remaining = args.slice(1);
+
+  for (let i = 0; i < remaining.length; i++) {
+    if ((remaining[i] === "--description" || remaining[i] === "-d") && remaining[i + 1]) {
+      description = remaining[++i];
+    } else if (remaining[i] === "--cwd" && remaining[i + 1]) {
+      cwd = remaining[++i];
+    } else if (!taskId && !remaining[i].startsWith("-")) {
+      taskId = remaining[i];
     }
   }
 
+  if (!taskId && !description) {
+    console.error("Usage: agentdesk team <TASK-ID>");
+    console.error("   or: agentdesk team -d \"description\"");
+    process.exit(1);
+  }
+
   const { runTeam } = await import("../cli/team.mjs");
   const code = await runTeam(taskId, { description, cwd });
   process.exit(code);

package/cli/team.mjs

@@ -36,19 +36,44 @@ export async function runTeam(taskId, opts = {}) {
   // Detect project and load config
   const project = detectProject(cwd);
   const config = loadConfig(cwd);
-  console.log(`Project: ${project.name || "unknown"} (${project.label})`);
-  console.log(`Task: ${taskId}`);
-
-  // Determine tracker and build task link
   const tracker = config.tracker || (project.hasLinear ? "linear" : null);
+
+  // If no task ID, handle based on tracker
+  let createTask = false;
+  if (!taskId) {
+    if (tracker) {
+      // Tracker configured but no task ID — agents will create a task
+      createTask = true;
+      taskId = `new-${Date.now().toString(36)}`;
+      console.log(`Project: ${project.name || "unknown"} (${project.label})`);
+      console.log(`Mode: Create new ${tracker} task from description`);
+    } else {
+      // No tracker — generate a label from description
+      taskId = description
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, "")
+        .trim()
+        .replace(/\s+/g, "-")
+        .slice(0, 40) || `task-${Date.now().toString(36)}`;
+      console.log(`Project: ${project.name || "unknown"} (${project.label})`);
+      console.log(`Task: ${taskId}`);
+    }
+  } else {
+    console.log(`Project: ${project.name || "unknown"} (${project.label})`);
+    console.log(`Task: ${taskId}`);
+  }
+
+  // Build task link (only for existing tasks with a tracker)
   let taskLink = null;
-  if (tracker === "linear" && config.linear?.workspace) {
-    taskLink = `https://linear.app/${config.linear.workspace}/issue/${taskId}`;
-  } else if (tracker === "jira" && config.jira?.baseUrl) {
-    taskLink = `${config.jira.baseUrl}/browse/${taskId}`;
-  } else if (tracker === "github") {
-    const repo = config.github?.repo || "";
-    if (repo) taskLink = `https://github.com/${repo}/issues/${taskId}`;
+  if (!createTask) {
+    if (tracker === "linear" && config.linear?.workspace) {
+      taskLink = `https://linear.app/${config.linear.workspace}/issue/${taskId}`;
+    } else if (tracker === "jira" && config.jira?.baseUrl) {
+      taskLink = `${config.jira.baseUrl}/browse/${taskId}`;
+    } else if (tracker === "github") {
+      const repo = config.github?.repo || "";
+      if (repo) taskLink = `https://github.com/${repo}/issues/${taskId}`;
+    }
   }
   if (tracker) console.log(`Tracker: ${tracker}`);
   if (taskLink) console.log(`Task: ${taskLink}`);
@@ -68,6 +93,20 @@ export async function runTeam(taskId, opts = {}) {
     prompt = prompt.replace(/\{\{#TASK_DESCRIPTION\}\}[\s\S]*?\{\{\/TASK_DESCRIPTION\}\}/g, "");
   }
 
+  // Create task instruction — when -d is used without a task ID and a tracker is configured
+  if (createTask && description) {
+    let createInstr = "\n\n## CREATE TASK\n\nNo task ID was provided. Before starting work, Jane MUST create a new task in the tracker:\n\n";
+    if (tracker === "linear") {
+      createInstr += `Create a Linear issue using the GraphQL API:\n- Endpoint: https://api.linear.app/graphql\n- Auth: Authorization: $LINEAR_API_KEY\n- Set the title based on the description below\n- After creation, use the returned identifier (e.g., KEN-530) as the task ID for the rest of the session\n`;
+    } else if (tracker === "jira") {
+      createInstr += `Create a Jira issue:\n- Endpoint: ${config.jira?.baseUrl || ""}/rest/api/3/issue\n- Auth: Basic auth with $JIRA_EMAIL and $JIRA_API_TOKEN\n- Set the summary based on the description below\n- After creation, use the returned key (e.g., PROJ-42) as the task ID for the rest of the session\n`;
+    } else if (tracker === "github") {
+      createInstr += `Create a GitHub issue:\n- Run: gh issue create --title "..." --body "..."\n- After creation, use the returned issue number as the task ID for the rest of the session\n`;
+    }
+    createInstr += `\nTask description: ${description}\n`;
+    prompt += createInstr;
+  }
+
   // Tracker integration — enable the matching section, strip the rest
   const trackers = ["LINEAR", "JIRA", "GITHUB"];
   for (const t of trackers) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kendoo.agentdesk/agentdesk",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {