@kendoo.agentdesk/agentdesk 0.15.6 → 0.16.1

package/CHANGELOG.md

@@ -8,6 +8,20 @@ All user-facing changes to AgentDesk. Each entry is tagged:
 
 Internal refactors, infrastructure changes, and architectural notes are not listed here.
 
+## [0.16.1] — 2026-04-18
+
+### Added
+- `[UI]` Project settings tracker section now includes a collapsible "dedicated AgentDesk user" recommendation with step-by-step setup per tracker — the same guidance the CLI wizard shows.
+- `[UI]` The Verify-credentials result now flags personal-looking accounts with a note suggesting a dedicated tracker user for cleaner attribution, matching the CLI's post-verify nudge.
+
+## [0.16.0] — 2026-04-18
+
+### Added
+- `[CLI]` `agentdesk init` now walks you through tracker setup as a guided wizard — numbered steps, a side-by-side "dedicated AgentDesk user vs. your own account" recommendation with per-tracker instructions (Linear, Jira, GitHub), and a final review screen before anything is written.
+- `[CLI]` After credentials verify, the wizard prints the identity your team will post under ("✓ Posting as: …"). If it looks like a personal account, a gentle nudge suggests rotating to a dedicated user for cleaner ticket attribution.
+- `[CLI]` Re-running `agentdesk init` in a project that already has config offers a "tracker only" shortcut instead of walking the whole wizard.
+- `[CLI]` `agentdesk init --quick` skips the narrative copy for power users and scripted setups.
+
 ## [0.15.6] — 2026-04-18
 
 ### Changed

package/bin/agentdesk.mjs

@@ -61,7 +61,7 @@ if (!command || command === "help" || command === "--help") {
   Commands:
     agentdesk login                        Sign in to AgentDesk
     agentdesk logout                       Sign out and remove credentials
-    agentdesk init                         Set up project and configure tracker
+    agentdesk init [--quick]               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
     agentdesk <agent> -d "..."             Run a single agent (jane, dennis, sam, bart, vera, luna, mark, nora)
@@ -142,7 +142,8 @@ else if (command === "logout") {
 
 else if (command === "init") {
   const { runInit } = await import("../cli/init.mjs");
-  await runInit(process.cwd());
+  const quick = args.slice(1).includes("--quick");
+  await runInit(process.cwd(), { quick });
 }
 
 else if (command === "team") {

package/cli/init.mjs

@@ -1,16 +1,94 @@
-// `agentdesk init` — interactive project setup with tracker configuration
+// `agentdesk init` — interactive project setup with tracker configuration.
+//
+// Run modes:
+//   agentdesk init             → full wizard with inline guidance
+//   agentdesk init --quick     → skip narrative copy for power users / re-runs
+//   (automatic) re-run         → when .agentdesk.json already exists, offer
+//                                 to edit only a specific section
 
 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 { loadConfig, pushConfig } from "./config.mjs";
 import { getStoredApiKey } from "./login.mjs";
 import { registerLocalProject } from "./projects.mjs";
 import { checkTrackerPermissions, resolveCredentialsFromEnv } from "./tracker-check.mjs";
 
 const SERVER = process.env.AGENTDESK_SERVER || "https://agentdesk.live";
 
+// Pretty dividers and tracker-specific "dedicated user" guidance.
+const TRACKER_GUIDANCE = {
+  linear: {
+    name: "Linear",
+    dedicatedSteps: [
+      "1. Open https://linear.app/<your-workspace>/settings/members",
+      "2. Invite a new member named \"AgentDesk\" to an email you control",
+      "3. Accept the invite from that email, log in as the new user",
+      "4. Go to https://linear.app/settings/api → Create key → label it \"AgentDesk\"",
+      "5. Paste the key when prompted below",
+    ],
+    personalNote: "Your own Linear account. Comments on tickets will appear under your name.",
+  },
+  jira: {
+    name: "Jira",
+    dedicatedSteps: [
+      "1. Open https://admin.atlassian.com/ → Directory → Invite users",
+      "2. Invite an email you control (e.g. agentdesk@yourdomain.com) as \"AgentDesk\"",
+      "3. Accept the invite and sign in as the new user",
+      "4. Go to https://id.atlassian.com/manage-profile/security/api-tokens → Create API token",
+      "5. Paste the email + token when prompted below",
+    ],
+    personalNote: "Your own Jira account. Comments on tickets will appear under your name.",
+  },
+  github: {
+    name: "GitHub",
+    dedicatedSteps: [
+      "GitHub enforces one account per human, so a \"dedicated bot user\" must be",
+      "a GitHub App (first-class bot identity, shows as agentdesk[bot] on comments).",
+      "That's a deeper install — not available yet in this wizard. For now:",
+      "  • Option A: Use gh CLI authenticated as yourself (quickest to get started)",
+      "  • Option B: Generate a Personal Access Token scoped to the repo",
+    ],
+    personalNote: "Your own GitHub account via gh CLI or a PAT. Comments appear under your name.",
+  },
+};
+
+function printDedicatedUserChoice(tracker, quick) {
+  if (quick || !tracker) return;
+  const g = TRACKER_GUIDANCE[tracker];
+  if (!g) return;
+  console.log("");
+  console.log(`  ${g.name} account — who will post the comments?`);
+  console.log("  ─────────────────────────────────────────────");
+  console.log("");
+  console.log("  Recommended:  Dedicated \"AgentDesk\" user");
+  console.log("    Clean audit trail, survives team changes, clear attribution.");
+  for (const line of g.dedicatedSteps) console.log(`    ${line}`);
+  console.log("");
+  console.log("  Quick start:  Your own account");
+  console.log(`    ${g.personalNote}`);
+  console.log("");
+  console.log("  (This wizard doesn't care which you pick — it only asks for the");
+  console.log("   credential. You're deciding whose credential to paste.)");
+  console.log("");
+}
+
+function printIdentityEcho(identity) {
+  if (!identity) return;
+  const label = identity.name || identity.login || identity.email || "(unknown)";
+  const extra = identity.email && identity.email !== identity.name ? ` <${identity.email}>` : "";
+  console.log(`  ✓ Posting as: ${label}${extra}`);
+  const looksLikePerson =
+    identity.name && !/agent\s*desk|agentdesk|bot|service/i.test(identity.name) &&
+    !/(^|[.+])(agentdesk|bot|svc|service)(@|$|[.+])/i.test(identity.email || "");
+  if (looksLikePerson) {
+    console.log("    (Looks like a personal account — comments will be attributed to this user.");
+    console.log("     If you'd rather have a dedicated AgentDesk identity, rotate the credential");
+    console.log("     to one generated under a dedicated tracker user and re-run `agentdesk init`.)");
+  }
+}
+
 function loadApiKey(dir) {
   const envPath = join(dir, ".env");
   if (!existsSync(envPath)) return getStoredApiKey();
@@ -76,7 +154,8 @@ async function fetchServerCreds(apiKey, projectKey) {
   return {};
 }
 
-export async function runInit(cwd) {
+export async function runInit(cwd, opts = {}) {
+  const quick = !!opts.quick;
   const project = detectProject(cwd);
   const existingConfig = loadConfig(cwd);
   const projectId = project.name || cwd.split("/").pop();
@@ -85,6 +164,26 @@ export async function runInit(cwd) {
 
   const rl = createInterface({ input: process.stdin, output: process.stdout });
 
+  // Re-run mode: if config already exists (and we're not in --quick), let
+  // the user jump to a specific section instead of walking the full wizard.
+  let editScope = "full";
+  if (hasConfig && !quick) {
+    console.log("");
+    console.log("  AgentDesk — existing project detected");
+    console.log("  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("");
+    const choice = await selectOption(rl, "What would you like to do?", [
+      { label: "Full setup (walk the whole wizard again)", value: "full" },
+      { label: "Tracker only (change tracker or credentials)", value: "tracker" },
+      { label: "Cancel", value: "cancel" },
+    ]);
+    if (choice.value === "cancel") {
+      rl.close();
+      return;
+    }
+    editScope = choice.value;
+  }
+
   console.log("");
   console.log("  AgentDesk — Project Setup");
   console.log("  ━━━━━━━━━━━━━━━━━━━━━━━━");
@@ -103,11 +202,20 @@ export async function runInit(cwd) {
 
   // --- Step 1: Project key ---
   const defaultKey = existingConfig.projectKey || projectId;
-  const keyAnswer = await ask(rl, `  Project key (${defaultKey}): `);
-  const finalProjectKey = keyAnswer.trim() || defaultKey;
-  console.log("");
+  let finalProjectKey;
+  if (editScope === "tracker") {
+    finalProjectKey = defaultKey;
+  } else {
+    console.log("  Step 1 of 4 — Project key");
+    console.log("");
+    const keyAnswer = await ask(rl, `  Project key (${defaultKey}): `);
+    finalProjectKey = keyAnswer.trim() || defaultKey;
+    console.log("");
+  }
 
   // --- Step 2: Tracker selection (platform first) ---
+  if (!quick) console.log(editScope === "tracker" ? "  Tracker setup" : "  Step 2 of 4 — Task tracker");
+  console.log("");
   const trackerOptions = [
     { label: "Linear", value: "linear" },
     { label: "Jira", value: "jira" },
@@ -119,6 +227,9 @@ export async function runInit(cwd) {
   const tracker = selected.value;
   console.log("");
 
+  // Inline guidance: dedicated-user vs personal, only when a tracker is picked.
+  printDedicatedUserChoice(tracker, quick);
+
   // --- Step 2: Tracker configuration (details + credentials) ---
   const config = {};
   if (tracker) config.tracker = tracker;
@@ -166,6 +277,7 @@ export async function runInit(cwd) {
 
       if (check.ok) {
         console.log("  ✓ Tracker permissions verified (read, create, update)");
+        printIdentityEcho(check.identity);
         console.log("");
         verified = true;
       } else {
@@ -329,7 +441,7 @@ export async function runInit(cwd) {
     }
   }
 
-  // --- Save .agentdesk.json ---
+  // --- Summary + confirm before write ---
   let merged = {};
   if (hasConfig) {
     try { merged = JSON.parse(readFileSync(configPath, "utf-8")); } catch {}
@@ -349,6 +461,24 @@ export async function runInit(cwd) {
     delete merged.github;
   }
 
+  if (!quick) {
+    console.log("  Review");
+    console.log("  ──────");
+    console.log(`    Project key:  ${merged.projectKey}`);
+    console.log(`    Tracker:      ${merged.tracker || "none"}`);
+    if (merged.linear) console.log(`    Linear:       workspace=${merged.linear.workspace || "-"}, team=${merged.linear.teamKey || "-"}`);
+    if (merged.jira) console.log(`    Jira:         ${merged.jira.baseUrl || "-"}, project=${merged.jira.project || "-"}`);
+    if (merged.github) console.log(`    GitHub:       ${merged.github.repo || "-"}`);
+    console.log("");
+    const confirm = (await ask(rl, "  Save this config? [Y/n]: ")).trim().toLowerCase();
+    if (confirm && confirm !== "y" && confirm !== "yes") {
+      console.log("  Cancelled — nothing written.");
+      rl.close();
+      return;
+    }
+    console.log("");
+  }
+
   writeFileSync(configPath, JSON.stringify(merged, null, 2) + "\n");
   console.log(`  Saved .agentdesk.json`);
 
@@ -385,14 +515,14 @@ export async function runInit(cwd) {
     if (res.ok) {
       console.log("  Registered with agentdesk.live");
     }
-    // Push settings to server
+    // Push settings to server via the shared helper so error surfacing is consistent.
     const key = loadApiKey(cwd);
     if (key) {
-      await fetch(`${SERVER}/api/projects/${finalProjectKey}/settings`, {
-        method: "PUT",
-        headers: { "Content-Type": "application/json", "x-api-key": key },
-        body: JSON.stringify(merged),
-      }).catch(() => {});
+      const push = await pushConfig(key, SERVER, finalProjectKey, merged);
+      if (!push.ok && push.error !== "missing_auth") {
+        console.log(`  ⚠  Could not push settings to agentdesk.live: ${push.error}`);
+        console.log("     Your local .agentdesk.json is saved; retry from the UI or re-run init.");
+      }
     }
   } catch {
     // Server not available

package/cli/tracker-check.mjs

@@ -29,13 +29,16 @@ async function checkLinear({ teamKey, workspace }, creds) {
   if (!apiKey) return { ok: false, errors: ["Missing LINEAR_API_KEY — configure it in the AgentDesk dashboard or .env"] };
 
   const errors = [];
+  let identity = null;
 
   // Check read: fetch viewer and team info
   try {
-    const viewerRes = await gql(apiKey, `{ viewer { id name } }`);
+    const viewerRes = await gql(apiKey, `{ viewer { id name email } }`);
     if (viewerRes.errors) {
       return { ok: false, errors: ["LINEAR_API_KEY is invalid or expired"] };
     }
+    const v = viewerRes.data?.viewer;
+    if (v) identity = { name: v.name, email: v.email, id: v.id };
   } catch (e) {
     return { ok: false, errors: [`Cannot reach Linear API: ${e.message}`] };
   }
@@ -77,7 +80,7 @@ async function checkLinear({ teamKey, workspace }, creds) {
     }
   }
 
-  return { ok: errors.length === 0, errors };
+  return { ok: errors.length === 0, errors, identity };
 }
 
 async function checkJira({ baseUrl, project }, creds) {
@@ -88,8 +91,21 @@ async function checkJira({ baseUrl, project }, creds) {
   if (!baseUrl) return { ok: false, errors: ["Missing Jira base URL — run 'agentdesk init' to configure"] };
 
   const errors = [];
+  let identity = null;
   const auth = "Basic " + Buffer.from(`${email}:${token}`).toString("base64");
 
+  // Fetch the authenticated user so we can report "Posting as X".
+  try {
+    const meRes = await fetch(`${baseUrl}/rest/api/3/myself`, {
+      headers: { Authorization: auth, Accept: "application/json" },
+      signal: AbortSignal.timeout(10000),
+    });
+    if (meRes.ok) {
+      const me = await meRes.json();
+      identity = { name: me.displayName || email, email: me.emailAddress || email, id: me.accountId };
+    }
+  } catch {}
+
   // Use Jira's mypermissions endpoint to check all permissions at once
   const permissionsToCheck = "BROWSE_PROJECTS,CREATE_ISSUES,EDIT_ISSUES,ADD_COMMENTS,TRANSITION_ISSUES";
   try {
@@ -133,13 +149,14 @@ async function checkJira({ baseUrl, project }, creds) {
     return { ok: false, errors: [`Cannot reach Jira at ${baseUrl}: ${e.message}`] };
   }
 
-  return { ok: errors.length === 0, errors };
+  return { ok: errors.length === 0, errors, identity };
 }
 
 async function checkGitHub({ repo }, creds) {
   if (!repo) return { ok: false, errors: ["Missing GitHub repo — run 'agentdesk init' to configure"] };
 
   const errors = [];
+  let identity = null;
 
   // Check if gh CLI is available
   try {
@@ -148,9 +165,14 @@ async function checkGitHub({ repo }, creds) {
     return { ok: false, errors: ["GitHub CLI (gh) is not installed — install it from https://cli.github.com"] };
   }
 
-  // Check auth status
+  // Check auth status and grab the authenticated login
   try {
     execSync("gh auth status", { stdio: "pipe" });
+    try {
+      const who = execSync(`gh api user --jq '{login: .login, name: .name}'`, { stdio: "pipe", encoding: "utf-8" }).trim();
+      const j = JSON.parse(who);
+      identity = { name: j.name || j.login, login: j.login };
+    } catch {}
   } catch {
     return { ok: false, errors: ["GitHub CLI is not authenticated — run 'gh auth login'"] };
   }
@@ -175,7 +197,7 @@ async function checkGitHub({ repo }, creds) {
     }
   }
 
-  return { ok: errors.length === 0, errors };
+  return { ok: errors.length === 0, errors, identity };
 }
 
 // Helper: execute a Linear GraphQL query

package/package.json

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