@kendoo.agentdesk/agentdesk 0.3.0 → 0.3.1

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
 
+With a task tracker:
+
 ```bash
 agentdesk team KEN-517
 agentdesk team BUG-42 -d "Fix the checkout total calculation"
 ```
 
+Without a tracker — pass requirements directly:
+
+```bash
+agentdesk team add-auth -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,12 +96,12 @@ 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 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
 ```
@@ -101,19 +110,17 @@ agentdesk team <TASK-ID> -d "..."      Run with a task description
 
 | 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,39 @@
 #!/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>
-
-  Usage:
-    agentdesk login                        Log in to AgentDesk
-    agentdesk logout                       Log out and remove credentials
-    agentdesk init                         Detect project and show setup info
+    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
+
+  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
 
   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
-    }
+  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"
 
   Examples:
-    agentdesk login
-    agentdesk init
     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"
 
   Dashboard: https://agentdesk.live
 `);

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/package.json

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