@kendoo.agentdesk/agentdesk 0.9.20 → 0.9.21

package/README.md

@@ -69,6 +69,7 @@ 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
+agentdesk <agent> -d "..."             Run a single agent (jane, dennis, sam, bart, vera, luna, mark)
 agentdesk daemon                       Start daemon for remote sessions
 agentdesk update                       Update to the latest version
 ```
@@ -113,6 +114,18 @@ You can also define them in `.agentdesk.json` as a local override if preferred.
 
 AgentDesk also auto-discovers agents from `.claude/agents/`, `.claude/commands/`, `.mcp.json`, GitHub Actions workflows, Dependabot, and Renovate configs.
 
+### Solo agent mode
+
+Run a single agent instead of the full team:
+
+```bash
+agentdesk jane -d "Create a customer journey plan for onboarding"
+agentdesk dennis KEN-517
+agentdesk vera -d "Add test coverage for the auth module"
+```
+
+The agent runs independently with its own expertise and ground rules. Useful for focused tasks that don't need full team collaboration.
+
 ### Custom instructions
 
 Add project-specific rules that all agents follow. Set via Web UI or in `.agentdesk.json`:

package/bin/agentdesk.mjs

@@ -64,6 +64,7 @@ if (!command || command === "help" || command === "--help") {
     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
+    agentdesk <agent> -d "..."             Run a single agent (jane, dennis, sam, etc.)
     agentdesk daemon                       Start daemon for remote sessions
     agentdesk update                       Update to the latest version
 
@@ -94,7 +95,36 @@ if (!command || command === "help" || command === "--help") {
   process.exit(0);
 }
 
-if (command === "login") {
+// Single-agent mode — agentdesk jane -d "...", agentdesk dennis TASK-123, etc.
+const AGENT_NAMES = ["jane", "dennis", "sam", "bart", "vera", "luna", "mark"];
+if (AGENT_NAMES.includes(command?.toLowerCase())) {
+  let description = "";
+  let cwd = process.cwd();
+  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 ${command} <TASK-ID>`);
+    console.error(`   or: agentdesk ${command} -d "description"`);
+    process.exit(1);
+  }
+
+  const { runTeam } = await import("../cli/team.mjs");
+  const code = await runTeam(taskId, { description, cwd, soloAgent: command.charAt(0).toUpperCase() + command.slice(1).toLowerCase() });
+  process.exit(code);
+}
+
+else if (command === "login") {
   const { runLogin } = await import("../cli/login.mjs");
   await runLogin();
 }

package/cli/orchestrator.mjs

@@ -5,7 +5,7 @@ import { existsSync, readFileSync, writeFileSync, unlinkSync } from "fs";
 import { createInterface } from "readline";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
-import { buildPrompt } from "./prompt.mjs";
+import { buildPrompt, buildSoloPrompt } from "./prompt.mjs";
 import { createStreamParser } from "./stream-parser.mjs";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -47,7 +47,7 @@ function timestamp() {
 export async function runOrchestrator({
   taskId, taskLink, description, createTask, tracker, config,
   project, team, teamSections, inboxUrl, sessionUrl, cwd,
-  onEvent, apiKey, serverUrl,
+  onEvent, apiKey, serverUrl, soloAgent,
 }) {
   const trackerCreds = await fetchTrackerCredentials(project?.name, apiKey, serverUrl);
   const env = { ...process.env, ...loadDotEnv(cwd), ...trackerCreds };
@@ -63,10 +63,9 @@ export async function runOrchestrator({
     onEvent?.({ ...event, timestamp: timestamp() });
   }
 
-  const fullPrompt = buildPrompt({
-    taskId, taskLink, description, createTask, tracker, config,
-    project, teamSections, inboxUrl, sessionUrl,
-  });
+  const fullPrompt = soloAgent
+    ? buildSoloPrompt({ agentName: soloAgent, taskId, description, tracker, config, project, sessionUrl })
+    : buildPrompt({ taskId, taskLink, description, createTask, tracker, config, project, teamSections, inboxUrl, sessionUrl });
 
   emit({
     type: "session:start",
@@ -74,11 +73,11 @@ export async function runOrchestrator({
     title: description || taskId,
     project: project?.name || null,
     sessionNumber: 1,
-    agents: teamSections.names,
+    agents: soloAgent ? [soloAgent] : teamSections.names,
     cliVersion: CLI_VERSION,
   });
 
-  emit({ type: "phase:change", phase: "INTAKE" });
+  emit({ type: "phase:change", phase: soloAgent ? "EXECUTION" : "INTAKE" });
 
   const child = spawn(
     "claude",

package/cli/prompt.mjs

@@ -4,6 +4,7 @@ import { readFileSync } from "fs";
 import { resolve, dirname } from "path";
 import { fileURLToPath } from "url";
 import { generateContext } from "./detect.mjs";
+import { BUILT_IN_AGENTS } from "./agents.mjs";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PROMPT_PATH = resolve(__dirname, "../prompts/team.md");
@@ -100,3 +101,84 @@ export function buildPrompt({ taskId, taskLink, description, createTask, tracker
 
   return `${prompt}\n\n---\n\n## PROJECT CONTEXT\n\n${context}\n\n${timeInfo}`;
 }
+
+export function buildSoloPrompt({ agentName, taskId, description, tracker, config, project, sessionUrl }) {
+  const agent = BUILT_IN_AGENTS[agentName];
+  if (!agent) throw new Error(`Unknown agent: ${agentName}`);
+
+  const lines = [
+    `# ${agentName} — ${agent.role} (Solo Mode)`,
+    ``,
+    `You are ${agentName}, ${agent.description}.`,
+    `You are working independently on this task — there is no team. You handle everything yourself.`,
+    ``,
+    agent.groundRules ? `## Ground Rules\n\n${agent.groundRules}` : "",
+    agent.codePrinciple ? `## Code Principles\n\n${agent.codePrinciple}` : "",
+    ``,
+    `## Task`,
+    ``,
+    taskId ? `Task ID: ${taskId}` : "",
+    description ? `Description: ${description}` : "",
+    sessionUrl ? `Session: ${sessionUrl}` : "",
+    ``,
+    `## Instructions`,
+    ``,
+    `Work on this task independently. Follow CLAUDE.md conventions if present.`,
+    `Read and understand the codebase before making changes.`,
+    ``,
+  ];
+
+  if (agent.execution?.tasks) {
+    lines.push(`## Your responsibilities`, ``);
+    for (const t of agent.execution.tasks) {
+      lines.push(`- ${t}`);
+    }
+    lines.push(``);
+  }
+
+  // Extract and include tracker integration from team prompt
+  if (tracker && taskId) {
+    let teamPrompt = readFileSync(PROMPT_PATH, "utf-8");
+
+    // Extract the matching tracker block
+    const trackerKey = tracker.toUpperCase();
+    const trackerRegex = new RegExp(`\\{\\{#${trackerKey}\\}\\}([\\s\\S]*?)\\{\\{\\/${trackerKey}\\}\\}`, "g");
+    let trackerSection = "";
+    let match;
+    while ((match = trackerRegex.exec(teamPrompt)) !== null) {
+      trackerSection += match[1] + "\n";
+    }
+
+    if (trackerSection) {
+      // Substitute variables
+      trackerSection = trackerSection.replace(/\{\{TASK_ID\}\}/g, taskId);
+      trackerSection = trackerSection.replace(/\{\{SESSION_URL\}\}/g, sessionUrl || "");
+      if (config.jira?.baseUrl) {
+        trackerSection = trackerSection.replace(/\{\{JIRA_BASE_URL\}\}/g, config.jira.baseUrl.replace(/\/+$/, ""));
+      }
+      lines.push(trackerSection);
+    }
+
+    lines.push(
+      `## Required tracker actions`,
+      ``,
+      `1. Fetch the task — read summary, description, status, comments, attachments.`,
+      `2. Post a comment: "${agentName} working on this task (solo mode). Session: ${sessionUrl || ""}"`,
+      `3. Do your work.`,
+      `4. Post a final comment summarizing what was done, what was omitted, and any manual steps required.`,
+      ``,
+    );
+  }
+
+  // Add custom instructions
+  if (config?.instructions) {
+    lines.push(`## Additional Instructions`, ``, config.instructions, ``);
+  }
+
+  // Add project context
+  const context = generateContext(project);
+  const now = new Date();
+  const timeInfo = `Current date/time: ${now.toLocaleDateString("en-US", { weekday: "long", year: "numeric", month: "long", day: "numeric" })} ${now.toLocaleTimeString("en-US", { hour: "2-digit", minute: "2-digit" })}`;
+
+  return lines.filter(Boolean).join("\n") + `\n\n---\n\n## PROJECT CONTEXT\n\n${context}\n\n${timeInfo}`;
+}

package/cli/team.mjs

@@ -87,6 +87,10 @@ export async function runTeam(taskId, opts = {}) {
     console.log(`Jira: ${cyan}${config.jira.baseUrl}${reset}`);
   }
 
+  if (opts.soloAgent) {
+    console.log(`Agent: ${opts.soloAgent} (solo mode)`);
+  }
+
   // Resolve team and generate dynamic prompt sections
   const team = resolveTeam(config);
   const teamSections = generateTeamPrompt(team, { tracker, config });
@@ -206,6 +210,7 @@ export async function runTeam(taskId, opts = {}) {
     onEvent: vizSend,
     apiKey,
     serverUrl: agentdeskServer,
+    soloAgent: opts.soloAgent || null,
   });
 
   clearInterval(heartbeatInterval);

package/package.json

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