@kendoo.agentdesk/agentdesk 0.1.1 → 0.2.1

package/README.md

@@ -24,20 +24,17 @@ npm i -g @kendoo.agentdesk/agentdesk
 
 Requires [Node.js](https://nodejs.org/) 18+ and [Claude Code](https://claude.ai/claude-code) installed.
 
-### 2. Create an account
-
-Sign up at [agentdesk.live](https://agentdesk.live) and copy your API key from **Settings**.
-
-### 3. Configure your project
-
-Add your API key to your project's `.env` file:
+### 2. Log in
 
 ```bash
-cd your-project
-echo "AGENTDESK_API_KEY=your-key-here" >> .env
+agentdesk login
 ```
 
-Run init to verify the setup:
+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
@@ -93,6 +90,8 @@ AgentDesk also auto-discovers agents from `.claude/agents/`, `.claude/commands/`
 ## 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

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;
@@ -152,7 +153,18 @@ export async function runTeam(taskId, opts = {}) {
       }
     });
     vizWs.on("error", () => { vizConnected = false; });
-    vizWs.on("close", () => { vizConnected = false; });
+    vizWs.on("close", (code) => {
+      vizConnected = false;
+      if (code === 1006 && !vizConnected) {
+        console.log("AgentDesk: not connected — run 'agentdesk login' to authenticate");
+      }
+    });
+    vizWs.on("unexpected-response", (_req, res) => {
+      if (res.statusCode === 401) {
+        console.log("AgentDesk: authentication required — run 'agentdesk login'");
+      }
+      vizConnected = false;
+    });
   } catch {
     // AgentDesk not running
   }

package/package.json

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