@kendoo.agentdesk/agentdesk 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,119 @@
+# 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).
+
+AgentDesk spawns a team of 7 specialized AI agents that collaborate on your tasks:
+
+| Agent | Role |
+|-------|------|
+| Jane | Product Lead — facilitates, clarifies requirements, coordinates the team |
+| Luna | UX/UI Designer — visual consistency, accessibility, interaction patterns |
+| Mark | Content Writer — copy, tone, user-facing text |
+| Sam | Architecture Auditor — code structure, separation of concerns |
+| Dennis | Senior Developer — implements the solution |
+| Bart | QA Engineer — edge cases, risks, acceptance criteria |
+| Vera | Test Engineer — unit tests, regression coverage |
+
+## Getting Started
+
+### 1. Install
+
+```bash
+npm i -g @kendoo.agentdesk/agentdesk
+```
+
+Requires [Node.js](https://nodejs.org/) 18+ and [Claude Code](https://claude.ai/claude-code) installed.
+
+### 2. Log 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`.
+
+### 3. Set up your project
+
+Navigate to your project and run init:
+
+```bash
+agentdesk init
+```
+
+### 4. Run a team session
+
+```bash
+agentdesk team KEN-517
+agentdesk team BUG-42 -d "Fix the checkout total calculation"
+```
+
+Open [agentdesk.live](https://agentdesk.live) to watch the session live.
+
+## Configuration
+
+Create `.agentdesk.json` in your project root to customize behavior:
+
+```json
+{
+  "tracker": "linear",
+  "linear": { "workspace": "your-workspace" }
+}
+```
+
+### Task trackers
+
+| Tracker | Config |
+|---------|--------|
+| Linear | `{ "tracker": "linear", "linear": { "workspace": "..." } }` |
+| Jira | `{ "tracker": "jira", "jira": { "baseUrl": "https://yourcompany.atlassian.net" } }` |
+| GitHub Issues | `{ "tracker": "github", "github": { "repo": "owner/repo" } }` |
+
+### Declaring project agents
+
+If your project has existing AI agents, bots, or automation, declare them so the team knows about them:
+
+```json
+{
+  "projectAgents": [
+    {
+      "name": "ReviewBot",
+      "role": "Auto-reviews PRs for security issues",
+      "when": "Triggers on every PR creation",
+      "how": "Comment /review on a PR to re-trigger"
+    }
+  ]
+}
+```
+
+AgentDesk also auto-discovers agents from `.claude/agents/`, `.claude/commands/`, `.mcp.json`, GitHub Actions workflows, Dependabot, and Renovate configs.
+
+## 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
+```
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `--description`, `-d` | Task description (for projects without a task tracker) |
+| `--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
+
+## 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

@@ -10,12 +10,13 @@ if (!command || command === "help" || command === "--help") {
   AgentDesk — AI team orchestrator for Claude Code
 
   Getting started:
-    1. Sign up at https://agentdesk.live and copy your API key from Settings
-    2. Add to your project's .env:  AGENTDESK_API_KEY=<your-key>
-    3. Run: agentdesk init
-    4. Run: agentdesk team <TASK-ID>
+    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
     agentdesk team <TASK-ID>               Run a team session on a task
     agentdesk team <TASK-ID> -d "..."      Run with a task description
@@ -32,6 +33,7 @@ if (!command || command === "help" || command === "--help") {
     }
 
   Examples:
+    agentdesk login
     agentdesk init
     agentdesk team KEN-517
     agentdesk team BUG-42 -d "Fix the checkout total calculation"
@@ -41,7 +43,17 @@ if (!command || command === "help" || command === "--help") {
   process.exit(0);
 }
 
-if (command === "init") {
+if (command === "login") {
+  const { runLogin } = await import("../cli/login.mjs");
+  await runLogin();
+}
+
+else if (command === "logout") {
+  const { runLogout } = await import("../cli/login.mjs");
+  await runLogout();
+}
+
+else if (command === "init") {
   const { runInit } = await import("../cli/init.mjs");
   await runInit(process.cwd());
 }

package/cli/init.mjs

@@ -4,14 +4,15 @@ import { existsSync, readFileSync } from "fs";
 import { join } from "path";
 import { detectProject } from "./detect.mjs";
 import { loadConfig } from "./config.mjs";
+import { getStoredApiKey } from "./login.mjs";
 
 const SERVER = process.env.AGENTDESK_SERVER || "https://agentdesk.live";
 
 function loadApiKey(dir) {
   const envPath = join(dir, ".env");
-  if (!existsSync(envPath)) return null;
+  if (!existsSync(envPath)) return getStoredApiKey();
   const match = readFileSync(envPath, "utf-8").match(/AGENTDESK_API_KEY=(.+)/);
-  return match?.[1]?.trim() || null;
+  return match?.[1]?.trim() || getStoredApiKey();
 }
 
 export async function runInit(cwd) {

package/cli/login.mjs

@@ -0,0 +1,129 @@
+// `agentdesk login` — authenticate with AgentDesk and save API key
+
+import { createServer } from "http";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { randomUUID } from "crypto";
+
+const AGENTDESK_SERVER = process.env.AGENTDESK_SERVER || "https://agentdesk.live";
+const CONFIG_DIR = join(process.env.HOME || process.env.USERPROFILE, ".agentdesk");
+const CREDENTIALS_PATH = join(CONFIG_DIR, "credentials.json");
+
+export function getStoredApiKey() {
+  if (!existsSync(CREDENTIALS_PATH)) return null;
+  try {
+    const creds = JSON.parse(readFileSync(CREDENTIALS_PATH, "utf-8"));
+    return creds.apiKey || null;
+  } catch { return null; }
+}
+
+export async function runLogin() {
+  console.log("");
+  console.log("  AgentDesk — Login");
+  console.log("  ━━━━━━━━━━━━━━━━");
+  console.log("");
+
+  // Check if already logged in
+  const existing = getStoredApiKey();
+  if (existing) {
+    console.log(`  Already logged in (key: ${existing.slice(0, 8)}...)`);
+    console.log("");
+    console.log("  To re-authenticate, run: agentdesk logout");
+    console.log("");
+    return;
+  }
+
+  const state = randomUUID();
+
+  // Start a local server to receive the API key callback
+  const server = createServer((req, res) => {
+    // Allow CORS from agentdesk.live
+    res.setHeader("Access-Control-Allow-Origin", "*");
+    res.setHeader("Access-Control-Allow-Methods", "GET, OPTIONS");
+    if (req.method === "OPTIONS") { res.writeHead(200); res.end(); return; }
+
+    const url = new URL(req.url, `http://localhost`);
+
+    if (url.pathname === "/callback") {
+      const apiKey = url.searchParams.get("api_key");
+      const name = url.searchParams.get("name");
+      const returnedState = url.searchParams.get("state");
+
+      // CSRF check
+      if (returnedState !== state) {
+        res.writeHead(400, { "Content-Type": "text/html" });
+        res.end("<html><body><h2>Invalid state. Please try again.</h2></body></html>");
+        return;
+      }
+
+      if (apiKey) {
+        // Save credentials
+        if (!existsSync(CONFIG_DIR)) mkdirSync(CONFIG_DIR, { recursive: true });
+        writeFileSync(CREDENTIALS_PATH, JSON.stringify({ apiKey, name, savedAt: Date.now() }, null, 2));
+
+        res.writeHead(200, { "Content-Type": "text/html" });
+        res.end(`<html><body style="background:#0f172a;color:#e2e8f0;font-family:system-ui;display:flex;align-items:center;justify-content:center;height:100vh;margin:0"><div style="text-align:center"><h2 style="color:#2dd4bf">Logged in to AgentDesk</h2><p>You can close this tab and return to your terminal.</p></div></body></html>`);
+
+        console.log(`  Logged in as ${name || "user"}`);
+        console.log(`  API key saved to ~/.agentdesk/credentials.json`);
+        console.log("");
+        console.log("  Next steps:");
+        console.log("    agentdesk init");
+        console.log("    agentdesk team TASK-123");
+        console.log("");
+
+        setTimeout(() => { server.close(); process.exit(0); }, 500);
+      } else {
+        res.writeHead(400, { "Content-Type": "text/html" });
+        res.end("<html><body><h2>Login failed. No API key received.</h2></body></html>");
+      }
+      return;
+    }
+
+    res.writeHead(404);
+    res.end();
+  });
+
+  // Find an available port
+  await new Promise((resolve) => {
+    server.listen(0, "127.0.0.1", resolve);
+  });
+  const port = server.address().port;
+
+  const loginUrl = `${AGENTDESK_SERVER}/cli-auth?port=${port}&state=${state}`;
+
+  console.log(`  Opening browser to log in...`);
+  console.log("");
+  console.log(`  If the browser doesn't open, visit:`);
+  console.log(`  ${loginUrl}`);
+  console.log("");
+  console.log("  Waiting for authentication...");
+
+  // Open browser
+  const { exec } = await import("child_process");
+  const platform = process.platform;
+  const cmd = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+  exec(`${cmd} "${loginUrl}"`);
+
+  // Timeout after 5 minutes
+  setTimeout(() => {
+    console.log("");
+    console.log("  Login timed out. Please try again.");
+    server.close();
+    process.exit(1);
+  }, 5 * 60 * 1000);
+}
+
+export async function runLogout() {
+  if (existsSync(CREDENTIALS_PATH)) {
+    const { unlinkSync } = await import("fs");
+    unlinkSync(CREDENTIALS_PATH);
+    console.log("");
+    console.log("  Logged out. Credentials removed.");
+    console.log("");
+  } else {
+    console.log("");
+    console.log("  Not logged in.");
+    console.log("");
+  }
+}

package/cli/team.mjs

@@ -9,6 +9,7 @@ import { randomUUID } from "crypto";
 import WebSocket from "ws";
 import { detectProject, generateContext } from "./detect.mjs";
 import { loadConfig } from "./config.mjs";
+import { getStoredApiKey } from "./login.mjs";
 
 function loadDotEnv(dir) {
   const envPath = join(dir, ".env");
@@ -96,7 +97,7 @@ export async function runTeam(taskId, opts = {}) {
 
   // --- AgentDesk config ---
   const projectEnv = loadDotEnv(cwd);
-  const apiKey = projectEnv.AGENTDESK_API_KEY || process.env.AGENTDESK_API_KEY || null;
+  const apiKey = projectEnv.AGENTDESK_API_KEY || process.env.AGENTDESK_API_KEY || getStoredApiKey() || null;
   const agentdeskServer = process.env.AGENTDESK_SERVER || "https://agentdesk.live";
   const baseUrl = process.env.AGENTDESK_URL || "wss://agentdesk.live/ws/agent";
   const AGENTDESK_URL = apiKey ? `${baseUrl}?api_key=${apiKey}` : baseUrl;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kendoo.agentdesk/agentdesk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {
@@ -9,7 +9,8 @@
   "files": [
     "bin/",
     "cli/",
-    "prompts/"
+    "prompts/",
+    "README.md"
   ],
   "engines": {
     "node": ">=18"