@kendoo.agentdesk/agentdesk 0.3.0 → 0.4.0

package/README.md

@@ -1,6 +1,6 @@
 # AgentDesk
 
-AI team orchestrator for [Claude Code](https://claude.ai/claude-code). Run collaborative agent sessions from your terminal and watch them live on [agentdesk.live](https://agentdesk.live).
+AI team orchestrator. Run collaborative agent sessions from your terminal and watch them live on [agentdesk.live](https://agentdesk.live).
 
 AgentDesk spawns a team of 7 specialized AI agents that collaborate on your tasks:
 
@@ -22,36 +22,44 @@ AgentDesk spawns a team of 7 specialized AI agents that collaborate on your task
 npm i -g @kendoo.agentdesk/agentdesk
 ```
 
-Requires [Node.js](https://nodejs.org/) 18+ and [Claude Code](https://claude.ai/claude-code) installed.
+Requires [Node.js](https://nodejs.org/) 18+.
 
-### 2. Log in
+### 2. Sign in
 
 ```bash
 agentdesk login
 ```
 
-This opens your browser to [agentdesk.live](https://agentdesk.live) where you sign up or log in. Your API key is saved automatically to `~/.agentdesk/credentials.json`.
+Opens your browser to [agentdesk.live](https://agentdesk.live) where you sign up or log in (email/password or Google). Your API key is saved automatically.
 
 ### 3. Set up your project
 
-Navigate to your project and run init:
-
 ```bash
 agentdesk init
 ```
 
+This detects your project, asks which task tracker you use (Linear, Jira, GitHub Issues, or none), and saves the config to `.agentdesk.json`.
+
 ### 4. Run a team session
 
+Work on an existing task:
+
 ```bash
 agentdesk team KEN-517
-agentdesk team BUG-42 -d "Fix the checkout total calculation"
+```
+
+Or just describe what you want — a task is created automatically:
+
+```bash
+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.
 
 ## Configuration
 
-Create `.agentdesk.json` in your project root to customize behavior:
+`agentdesk init` creates `.agentdesk.json` in your project root. You can also edit it manually:
 
 ```json
 {
@@ -65,8 +73,9 @@ Create `.agentdesk.json` in your project root to customize behavior:
 | Tracker | Config |
 |---------|--------|
 | Linear | `{ "tracker": "linear", "linear": { "workspace": "..." } }` |
-| Jira | `{ "tracker": "jira", "jira": { "baseUrl": "https://yourcompany.atlassian.net" } }` |
+| Jira | `{ "tracker": "jira", "jira": { "baseUrl": "https://company.atlassian.net" } }` |
 | GitHub Issues | `{ "tracker": "github", "github": { "repo": "owner/repo" } }` |
+| None | No config needed — pass `-d "description"` when running a session |
 
 ### Declaring project agents
 
@@ -87,33 +96,31 @@ If your project has existing AI agents, bots, or automation, declare them so the
 
 AgentDesk also auto-discovers agents from `.claude/agents/`, `.claude/commands/`, `.mcp.json`, GitHub Actions workflows, Dependabot, and Renovate configs.
 
-## Usage
+## Commands
 
 ```
-agentdesk login                        Log in to AgentDesk
-agentdesk logout                       Log out and remove credentials
-agentdesk init                         Detect project and show setup info
-agentdesk team <TASK-ID>               Run a team session on a task
-agentdesk team <TASK-ID> -d "..."      Run with a task description
+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 an existing task
+agentdesk team -d "..."                Describe what you want — task created automatically
 ```
 
 ### Options
 
 | Flag | Description |
 |------|-------------|
-| `--description`, `-d` | Task description (for projects without a task tracker) |
+| `--description`, `-d` | Task description or requirements |
 | `--cwd` | Working directory (defaults to current) |
 
 ## How It Works
 
 1. You run `agentdesk team TASK-ID` in your project directory
 2. AgentDesk detects your project type, reads `CLAUDE.md`, and discovers existing agents
-3. A Claude Code session starts with all 7 agents collaborating on your task
-4. The team goes through structured phases: **Brainstorm** > **Planning** > **Execution** > **Review**
-5. The session streams live to [agentdesk.live](https://agentdesk.live) where you can watch and send messages to the team
+3. 7 AI agents collaborate on your task in structured phases: **Brainstorm** > **Planning** > **Execution** > **Review**
+4. The session streams live to [agentdesk.live](https://agentdesk.live) where you can watch and send messages to the team
 
 ## Requirements
 
 - [Node.js](https://nodejs.org/) 18+
-- [Claude Code](https://claude.ai/claude-code) CLI installed and authenticated
 - An AgentDesk account at [agentdesk.live](https://agentdesk.live)

package/bin/agentdesk.mjs

@@ -1,42 +1,42 @@
 #!/usr/bin/env node
 
-// AgentDesk CLI — AI team orchestrator for Claude Code
+// AgentDesk CLI — AI team orchestrator
 
 const args = process.argv.slice(2);
 const command = args[0];
 
 if (!command || command === "help" || command === "--help") {
   console.log(`
-  AgentDesk — AI team orchestrator for Claude Code
+  AgentDesk — AI team orchestrator
 
   Getting started:
-    1. Run: agentdesk login
-    2. Run: agentdesk init
-    3. Run: agentdesk team <TASK-ID>
+    1. agentdesk login          Sign in to your account
+    2. agentdesk init           Set up your project (choose tracker, save config)
+    3. agentdesk team TASK-123  Run a team session
 
-  Usage:
-    agentdesk login                        Log in to AgentDesk
-    agentdesk logout                       Log out and remove credentials
-    agentdesk init                         Detect project and show setup info
-    agentdesk team <TASK-ID>               Run a team session on a task
-    agentdesk team <TASK-ID> -d "..."      Run with a task description
+  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 an existing task
+    agentdesk team -d "..."                Create a task and run a session
 
   Options:
-    --description, -d    Task description (for projects without a task tracker)
+    --description, -d    Task description or requirements
     --cwd                Working directory (defaults to current)
 
-  Configuration:
-    Create .agentdesk.json in your project root:
-    {
-      "tracker": "linear",              // "linear" | "jira" | "github"
-      "linear": { "workspace": "..." }  // for task links in the dashboard
-    }
+  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 login
-    agentdesk init
     agentdesk team KEN-517
-    agentdesk team BUG-42 -d "Fix the checkout total calculation"
+    agentdesk team -d "Fix the checkout total calculation"
+    agentdesk team -d "Add Google OAuth to the login page"
 
   Dashboard: https://agentdesk.live
 `);
@@ -59,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/init.mjs

@@ -1,7 +1,8 @@
-// `agentdesk init` — detect project and register with AgentDesk server
+// `agentdesk init` — interactive project setup with tracker configuration
 
-import { existsSync, readFileSync } from "fs";
+import { existsSync, readFileSync, writeFileSync } from "fs";
 import { join } from "path";
+import { createInterface } from "readline";
 import { detectProject } from "./detect.mjs";
 import { loadConfig } from "./config.mjs";
 import { getStoredApiKey } from "./login.mjs";
@@ -15,11 +16,34 @@ function loadApiKey(dir) {
   return match?.[1]?.trim() || getStoredApiKey();
 }
 
+function ask(rl, question) {
+  return new Promise(resolve => rl.question(question, resolve));
+}
+
+async function selectOption(rl, prompt, options) {
+  console.log(`  ${prompt}`);
+  console.log("");
+  options.forEach((opt, i) => {
+    console.log(`    ${i + 1}) ${opt.label}`);
+  });
+  console.log("");
+
+  while (true) {
+    const answer = await ask(rl, `  Choose (1-${options.length}): `);
+    const num = parseInt(answer.trim(), 10);
+    if (num >= 1 && num <= options.length) return options[num - 1];
+    console.log(`  Please enter a number between 1 and ${options.length}`);
+  }
+}
+
 export async function runInit(cwd) {
   const project = detectProject(cwd);
-  const config = loadConfig(cwd);
-  const tracker = config.tracker || (project.hasLinear ? "linear" : null);
+  const existingConfig = loadConfig(cwd);
   const projectId = project.name || cwd.split("/").pop();
+  const configPath = join(cwd, ".agentdesk.json");
+  const hasConfig = existsSync(configPath);
+
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
 
   console.log("");
   console.log("  AgentDesk — Project Setup");
@@ -28,9 +52,8 @@ export async function runInit(cwd) {
   console.log(`  Project:      ${project.name || "unknown"}`);
   console.log(`  Type:         ${project.label}`);
   console.log(`  Directory:    ${project.dir}`);
-  console.log(`  Git:          ${project.hasGit ? "✓" : "✗"}`);
-  console.log(`  CLAUDE.md:    ${project.hasClaudeMd ? "✓" : "✗ (recommended — run 'claude' to generate one)"}`);
-  console.log(`  Tracker:      ${tracker || "— (none)"}`);
+  console.log(`  Git:          ${project.hasGit ? "yes" : "no"}`);
+  console.log(`  CLAUDE.md:    ${project.hasClaudeMd ? "yes" : "no (recommended)"}`);
   console.log("");
 
   if (project.testCommand) console.log(`  Test:         ${project.testCommand}`);
@@ -38,7 +61,68 @@ export async function runInit(cwd) {
   if (project.lintCommand) console.log(`  Lint:         ${project.lintCommand}`);
   if (project.testCommand || project.buildCommand || project.lintCommand) console.log("");
 
-  // Register with AgentDesk server
+  // --- Tracker selection ---
+  const trackerOptions = [
+    { label: "Linear", value: "linear" },
+    { label: "Jira", value: "jira" },
+    { label: "GitHub Issues", value: "github" },
+    { label: "None (use descriptions only)", value: null },
+  ];
+
+  const selected = await selectOption(rl, "Task tracker:", trackerOptions);
+  const tracker = selected.value;
+  console.log("");
+
+  // Build config
+  const config = {};
+  if (tracker) config.tracker = tracker;
+
+  if (tracker === "linear") {
+    const current = existingConfig.linear?.workspace || "";
+    const answer = await ask(rl, `  Linear workspace slug${current ? ` (${current})` : ""}: `);
+    const ws = answer.trim() || current;
+    if (ws) config.linear = { workspace: ws };
+    console.log("");
+  }
+
+  if (tracker === "jira") {
+    const current = existingConfig.jira?.baseUrl || "";
+    const answer = await ask(rl, `  Jira base URL${current ? ` (${current})` : ""}: `);
+    const url = answer.trim() || current;
+    if (url) config.jira = { baseUrl: url };
+    console.log("");
+  }
+
+  if (tracker === "github") {
+    const current = existingConfig.github?.repo || "";
+    const answer = await ask(rl, `  GitHub repo${current ? ` (${current})` : ""} (owner/repo): `);
+    const r = answer.trim() || current;
+    if (r) config.github = { repo: r };
+    console.log("");
+  }
+
+  // --- Save .agentdesk.json ---
+  let merged = {};
+  if (hasConfig) {
+    try { merged = JSON.parse(readFileSync(configPath, "utf-8")); } catch {}
+  }
+
+  if (tracker) {
+    merged.tracker = tracker;
+    if (config.linear) merged.linear = config.linear;
+    if (config.jira) merged.jira = config.jira;
+    if (config.github) merged.github = config.github;
+  } else {
+    delete merged.tracker;
+    delete merged.linear;
+    delete merged.jira;
+    delete merged.github;
+  }
+
+  writeFileSync(configPath, JSON.stringify(merged, null, 2) + "\n");
+  console.log(`  Saved .agentdesk.json`);
+
+  // --- Register with server ---
   try {
     const res = await fetch(`${SERVER}/api/projects`, {
       method: "POST",
@@ -55,24 +139,27 @@ export async function runInit(cwd) {
       }),
     });
     if (res.ok) {
-      console.log("  ✓ Registered with AgentDesk server");
-    } else {
-      console.log("  ⚠ AgentDesk server not available — project will register on first session");
+      console.log("  Registered with agentdesk.live");
     }
   } catch {
-    console.log("  ⚠ AgentDesk server not running — start it with: agentdesk server");
+    // Server not available
   }
 
   console.log("");
-  console.log("  Ready. Run a team session with:");
+  console.log("  Ready! Run a team session:");
   console.log("");
-  console.log(`    agentdesk team TASK-123`);
-  console.log(`    agentdesk team TASK-123 --description "Fix the login bug"`);
+  if (tracker) {
+    console.log(`    agentdesk team TASK-123`);
+    console.log(`    agentdesk team TASK-123 -d "Optional extra context"`);
+  } else {
+    console.log(`    agentdesk team my-feature -d "Add dark mode support"`);
+  }
   console.log("");
 
   if (!project.hasClaudeMd) {
-    console.log("  Tip: Create a CLAUDE.md in your project root to help the agents");
-    console.log("  understand your codebase conventions, architecture, and commands.");
+    console.log("  Tip: Create a CLAUDE.md to help the agents understand your codebase.");
     console.log("");
   }
+
+  rl.close();
 }

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.0",
+  "version": "0.4.0",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {