@kendoo.agentdesk/agentdesk 0.13.1 → 0.14.1

package/README.md

@@ -141,6 +141,36 @@ Add project-specific rules that all agents follow. Set via Web UI or in `.agentd
 
 Instructions are injected into the team prompt. Use them for project conventions that go beyond what `CLAUDE.md` covers (e.g., tracker workflow rules, PR policies, agent coordination preferences).
 
+### Screenshots
+
+Screenshots are captured by default for UI-related tasks. Bart captures desktop and mobile screenshots before creating the PR and attaches them to the task tracker.
+
+To disable, set `screenshots` to `false` in `.agentdesk.json` or toggle it off in project settings:
+
+```json
+{
+  "screenshots": false
+}
+```
+
+You can also toggle screenshots per session when starting a task from the Web UI.
+
+### Model per phase
+
+In phased mode (`INTAKE → PLAN → EXECUTION`), you can pick a different Claude model per phase from project settings. Useful when you want a stronger model for planning and implementation but a cheaper one for intake.
+
+```json
+{
+  "phaseModels": {
+    "INTAKE": "sonnet",
+    "PLAN": "opus",
+    "EXECUTION": "opus"
+  }
+}
+```
+
+Valid values: `"default"` (Claude Code's default), `"opus"`, `"sonnet"`, `"haiku"`. Non-phased runs use the `EXECUTION` model.
+
 ## How It Works
 
 All agents collaborate in a single Claude process — each with distinct roles, ground rules, and areas of expertise.

package/cli/config.mjs

@@ -39,6 +39,15 @@ const DEFAULTS = {
   // Each entry: { name, role, when, how }
   projectAgents: [],
 
+  // Capture screenshots for UI tasks (default: on)
+  screenshots: true,
+
+  // Model per phase — override Claude Code's default per phase.
+  // Keys: INTAKE, PLAN, EXECUTION. Values: "default" | "opus" | "sonnet" | "haiku".
+  // Missing entry or "default" = use Claude Code's default model.
+  // Example: { "PLAN": "opus", "EXECUTION": "opus" }
+  phaseModels: {},
+
   // Extra prompt instructions appended to the team prompt
   instructions: null,
 };

package/cli/daemon.mjs

@@ -313,7 +313,7 @@ export async function runDaemon() {
 
   // 4. Session handling
 
-  async function handleStartSession({ sessionId, projectId, taskId: remoteTaskId, prompt, phased }) {
+  async function handleStartSession({ sessionId, projectId, taskId: remoteTaskId, prompt, phased, screenshots: screenshotsOverride }) {
     // Validate project against local allowlist
     const project = projects.find(p => p.id === projectId);
     if (!project) {
@@ -343,6 +343,7 @@ export async function runDaemon() {
       const projectEnv = loadDotEnv(project.path);
       const projectApiKey = projectEnv.AGENTDESK_API_KEY || process.env.AGENTDESK_API_KEY || apiKey;
       const config = await loadConfig(project.path, { apiKey: projectApiKey, serverUrl: agentdeskServer, projectName: project.name });
+      if (screenshotsOverride !== undefined) config.screenshots = screenshotsOverride;
       const tracker = config.tracker || null;
 
       // Use provided task ID or generate from description

package/cli/orchestrator.mjs

@@ -44,6 +44,21 @@ function timestamp() {
     .map(n => String(n).padStart(2, "0")).join(":");
 }
 
+// Resolve --model args for a given phase based on project settings.
+// phaseModels is { INTAKE?, PLAN?, EXECUTION? } with values "opus"|"sonnet"|"haiku"|"default".
+// Returns [] when no override (so Claude Code picks its default).
+function modelArgsForPhase(phase, phaseModels) {
+  const choice = phaseModels?.[phase];
+  if (!choice || choice === "default") return [];
+  // Claude Code accepts short aliases: opus, sonnet, haiku
+  return ["--model", choice];
+}
+
+// Display label for a phase's model ("opus"|"sonnet"|"haiku"|"default").
+function modelLabelForPhase(phase, phaseModels) {
+  return phaseModels?.[phase] || "default";
+}
+
 export async function runOrchestrator({
   taskId, taskLink, description, createTask, tracker, config,
   project, team, teamSections, sessionUrl, cwd,
@@ -77,11 +92,16 @@ export async function runOrchestrator({
     cliVersion: CLI_VERSION,
   });
 
-  emit({ type: "phase:change", phase: soloAgent ? "EXECUTION" : "INTAKE" });
+  const initialPhase = soloAgent ? "EXECUTION" : "INTAKE";
+  // Non-phased single run spans all phases in one process — use EXECUTION's model
+  // as the representative choice (matches where the heavy lifting happens).
+  const representativeModel = modelLabelForPhase("EXECUTION", config?.phaseModels);
+  emit({ type: "phase:change", phase: initialPhase, model: representativeModel });
 
+  const modelArgs = modelArgsForPhase("EXECUTION", config?.phaseModels);
   const child = spawn(
     "claude",
-    ["-p", fullPrompt, "--allowedTools", "Bash,Read,Edit,Write,Glob,Grep", "--verbose", "--output-format", "stream-json"],
+    ["-p", fullPrompt, ...modelArgs, "--allowedTools", "Bash,Read,Edit,Write,Glob,Grep", "--verbose", "--output-format", "stream-json"],
     { stdio: ["pipe", "pipe", "inherit"], shell: false, env, cwd }
   );
   child.stdin.end();
@@ -89,7 +109,7 @@ export async function runOrchestrator({
   const { parseLine } = createStreamParser({
     teamNames: soloAgent ? [soloAgent] : teamSections.names,
     callbacks: {
-      onPhaseChange({ phase }) { emit({ type: "phase:change", phase }); },
+      onPhaseChange({ phase }) { emit({ type: "phase:change", phase, model: representativeModel }); },
       onAgentMessage({ agent, tag, message }) { emit({ type: "agent:message", agent, tag, message }); },
       onToolUse({ agent, tool, description }) { totalSteps++; emit({ type: "tool:use", agent, tool, description }); },
       onToolResult({ success, summary }) { emit({ type: "tool:result", success, summary }); },
@@ -174,10 +194,10 @@ export async function runOrchestrator({
 
 // --- Phased orchestrator: runs 3 sequential Claude processes ---
 
-async function runSinglePhase({ prompt, cwd, env, teamNames, emit }) {
+async function runSinglePhase({ prompt, cwd, env, teamNames, emit, modelArgs = [] }) {
   const child = spawn(
     "claude",
-    ["-p", prompt, "--allowedTools", "Bash,Read,Edit,Write,Glob,Grep", "--verbose", "--output-format", "stream-json"],
+    ["-p", prompt, ...modelArgs, "--allowedTools", "Bash,Read,Edit,Write,Glob,Grep", "--verbose", "--output-format", "stream-json"],
     { stdio: ["pipe", "pipe", "inherit"], shell: false, env, cwd }
   );
   child.stdin.end();
@@ -252,7 +272,7 @@ export async function runPhasedOrchestrator({
       if (existsSync(sessionMemoryPath)) sessionMemory = readFileSync(sessionMemoryPath, "utf-8").trim();
     } catch {}
 
-    emit({ type: "phase:change", phase });
+    emit({ type: "phase:change", phase, model: modelLabelForPhase(phase, config?.phaseModels) });
 
     const prompt = buildPhasedPrompt({
       phase, taskId, taskLink, description,
@@ -260,7 +280,8 @@ export async function runPhasedOrchestrator({
       tracker, config, project, teamSections, sessionUrl, cwd, sessionMemory,
     });
 
-    const result = await runSinglePhase({ prompt, cwd, env, teamNames, emit });
+    const modelArgs = modelArgsForPhase(phase, config?.phaseModels);
+    const result = await runSinglePhase({ prompt, cwd, env, teamNames, emit, modelArgs });
 
     // Allow daemon to track the child process for cancellation
     if (onChild) onChild(result.child);

package/cli/prompt.mjs

@@ -77,6 +77,16 @@ export function buildPrompt({ taskId, taskLink, description, createTask, tracker
     prompt += createInstr;
   }
 
+  // Screenshots toggle — default on if not explicitly set to false
+  const screenshotsEnabled = config.screenshots !== false;
+  if (screenshotsEnabled) {
+    prompt = prompt.replace(/\{\{#SCREENSHOTS_ENABLED\}\}([\s\S]*?)\{\{\/SCREENSHOTS_ENABLED\}\}/g, "$1");
+    prompt = prompt.replace(/\{\{#SCREENSHOTS_DISABLED\}\}[\s\S]*?\{\{\/SCREENSHOTS_DISABLED\}\}/g, "");
+  } else {
+    prompt = prompt.replace(/\{\{#SCREENSHOTS_ENABLED\}\}[\s\S]*?\{\{\/SCREENSHOTS_ENABLED\}\}/g, "");
+    prompt = prompt.replace(/\{\{#SCREENSHOTS_DISABLED\}\}([\s\S]*?)\{\{\/SCREENSHOTS_DISABLED\}\}/g, "$1");
+  }
+
   // Tracker integration — enable the matching section, strip the rest
   const trackers = ["LINEAR", "JIRA", "GITHUB"];
   for (const t of trackers) {
@@ -395,6 +405,16 @@ export function buildPhasedPrompt({ phase, taskId, taskLink, description, create
     prompt = prompt.replace(/\{\{#TASK_DESCRIPTION\}\}[\s\S]*?\{\{\/TASK_DESCRIPTION\}\}/g, "");
   }
 
+  // Screenshots toggle
+  const phasedScreenshots = config.screenshots !== false;
+  if (phasedScreenshots) {
+    prompt = prompt.replace(/\{\{#SCREENSHOTS_ENABLED\}\}([\s\S]*?)\{\{\/SCREENSHOTS_ENABLED\}\}/g, "$1");
+    prompt = prompt.replace(/\{\{#SCREENSHOTS_DISABLED\}\}[\s\S]*?\{\{\/SCREENSHOTS_DISABLED\}\}/g, "");
+  } else {
+    prompt = prompt.replace(/\{\{#SCREENSHOTS_ENABLED\}\}[\s\S]*?\{\{\/SCREENSHOTS_ENABLED\}\}/g, "");
+    prompt = prompt.replace(/\{\{#SCREENSHOTS_DISABLED\}\}([\s\S]*?)\{\{\/SCREENSHOTS_DISABLED\}\}/g, "$1");
+  }
+
   // Tracker integration
   const trackers = ["LINEAR", "JIRA", "GITHUB"];
   for (const t of trackers) {

package/package.json

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

package/prompts/phased.md

@@ -274,9 +274,16 @@ Speaking order:
 - Do NOT modify files unrelated to the task.
 - When posting screenshots to Linear, post them as a SEPARATE comment.
 
+{{#SCREENSHOTS_ENABLED}}
 ## SCREENSHOTS
 
-When a task involves UI changes, Bart captures screenshots after code changes are finalized, before creating the PR. Adapt auth to the actual project.
+Screenshots are **enabled** for this project. When a task involves UI changes, Bart MUST capture screenshots after code changes are finalized, before creating the PR. Adapt auth to the actual project.
+{{/SCREENSHOTS_ENABLED}}
+{{#SCREENSHOTS_DISABLED}}
+## SCREENSHOTS
+
+Screenshots are **disabled** for this project. Do NOT capture screenshots unless the user explicitly requests them.
+{{/SCREENSHOTS_DISABLED}}
 
 {{#LINEAR}}
 Upload via Linear's fileUpload mutation, then post image URLs as a separate comment.

package/prompts/team.md

@@ -56,9 +56,10 @@ This is a hard constraint that MUST NOT be violated under any circumstances:
 - Do NOT modify files unrelated to the task.
 - When posting screenshots to Linear, post them as a SEPARATE comment — never inside badge blocks.
 
+{{#SCREENSHOTS_ENABLED}}
 ## SCREENSHOTS
 
-When a task involves UI changes, capture screenshots of affected views.
+Screenshots are **enabled** for this project. When a task involves UI changes, Bart MUST capture screenshots — this is not optional.
 
 - **Jane** flags UI tasks during planning.
 - **Luna** defines what to capture (pages, viewports).
@@ -75,6 +76,12 @@ kill $DEV_PID 2>/dev/null
 ```
 
 Adapt auth to the actual project — no placeholders. If the project uses OAuth with no test credentials, skip screenshots with an explanation.
+{{/SCREENSHOTS_ENABLED}}
+{{#SCREENSHOTS_DISABLED}}
+## SCREENSHOTS
+
+Screenshots are **disabled** for this project. Do NOT capture screenshots unless the user explicitly requests them in the task description.
+{{/SCREENSHOTS_DISABLED}}
 
 ### Uploading screenshots