clideck 1.26.0 → 1.26.3

package/README.md

@@ -4,7 +4,7 @@
 
 > **Formerly `termix-cli`** — if you arrived here from an old link, you're in the right place. The project has been renamed to **CliDeck**. Update your install: `npm install -g clideck`
 
-Manage your AI agents like WhatsApp chats.
+Manage your AI agents like WhatsApp chats. Assign roles, let Autopilot route work between them, check in from your phone.
 
 [Documentation](https://docs.clideck.dev/) | [Video Demo](https://youtu.be/hICrtjGAeDk) | [Website](https://clideck.dev/)
 
@@ -14,6 +14,8 @@ You run Claude Code, Codex, Gemini CLI in separate terminals. You alt-tab betwee
 
 clideck puts all your agents in one screen — a sidebar with every session, live status, last message preview, and timestamps. Click a session, you're in its terminal. Exactly like switching between chats.
 
+Give each agent a role (Programmer, Reviewer, Product Manager), turn on Autopilot, and walk away — it routes output between agents automatically until the task is done or it needs you. Check progress from your phone with a QR scan.
+
 Native terminals. Your keystrokes go straight to the agent, nothing in between. clideck never reads your prompts or output.
 
 ## Quick Start
@@ -22,7 +24,9 @@ Native terminals. Your keystrokes go straight to the agent, nothing in between.
 npx clideck
 ```
 
-Open [http://localhost:4000](http://localhost:4000). Click **+**, pick an agent, start working.
+Open [http://localhost:4000](http://localhost:4000). Click **+**, pick an agent and optionally a project and role, start working.
+
+New users get 3 built-in demo roles (Programmer, Reviewer, Product Manager) and 3 starter prompts in the prompt library to get going quickly.
 
 Or install globally:
 
@@ -33,6 +37,9 @@ clideck
 
 ## What You Get
 
+- **Roles** — define reusable agent identities (Programmer, Reviewer, PM) and assign them when creating sessions. Instructions are injected into the agent automatically.
+- **Autopilot** — project-level workflow routing. Watches your role-assigned agents, waits for them to finish, forwards output to the next specialist. Fingerprints each output, tracks handoff history, and guards against repeat loops. Works with any LLM provider (Anthropic, OpenAI, Google, Groq, xAI, Mistral, and more). Notifies you when work is complete or blocked.
+- **Mobile access** — check on your agents from your phone with a QR scan. E2E encrypted.
 - **Live working/idle status** — see which agent is thinking and which is waiting for you, without checking each terminal
 - **Session resume** — close clideck, reopen it tomorrow, pick up where you left off
 - **Notifications** — browser and sound alerts when an agent finishes or needs input
@@ -40,12 +47,16 @@ clideck
 - **Projects** — group sessions by project with drag-and-drop
 - **Search** — find any session by name or scroll back through transcript content
 - **Prompt Library** — save reusable prompts, type `//` in any terminal to paste them
-- **Plugins** — ships with Voice Input and Trim Clip, or build your own
+- **Plugins** — full server + client API with hooks for input, output, status, transcript, and menus. Programmatic session control, toolbar and project actions, session pills, and a settings UI. Ships with Voice Input, Trim Clip, and Autopilot — or build your own.
 - **15 themes** — dark and light, plus custom theme support
 
 ## Mobile Access
 
-Check on your agents from your phone. Start a task, walk away, glance at your phone — see who's done, who's working, who needs input. Pair with one QR scan, no account needed. E2E encrypted — the relay cannot read your code.
+Start a task on your laptop, walk away, check progress from your phone. See who's working, who's idle, who needs input. Send messages, answer choice menus, browse conversation history, and resume sessions — all from the browser on your phone.
+
+Pair with one QR scan, no account needed. End-to-end encrypted with AES-256-GCM — the relay sees only opaque blobs. Your code never leaves your machines.
+
+Mobile access is provided by [`clideck-remote`](https://www.npmjs.com/package/clideck-remote), a separate optional package. Install it with `npm install -g clideck-remote`.
 
 ## Supported Agents
 
@@ -65,6 +76,8 @@ Claude Code works out of the box. Other agents need a one-time setup that clidec
 
 Each agent runs in a real terminal (PTY) on your machine. clideck receives lightweight status signals via OpenTelemetry — it knows *that* an agent is working, not *what* it's working on.
 
+Autopilot routes existing agent output between agents verbatim — it does not rewrite or summarize the routed content.
+
 Everything runs locally. No data is collected, transmitted, or stored outside your machine.
 
 ## Platform Support

package/activity.js

@@ -13,8 +13,11 @@ function ensure(id) {
 function trackIn(id, bytes) {
   ensure(id);
   net[id].in += bytes;
+  stream[id].lastInAt = Date.now();
 }
 
+function lastInputAt(id) { return stream[id]?.lastInAt || 0; }
+
 function trackOut(id, data) {
   ensure(id);
   const now = Date.now();
@@ -22,6 +25,7 @@ function trackOut(id, data) {
   net[id].out += data.length;
   if (now - s.lastOutAt > 2000) s.burstStart = now;
   s.lastOutAt = now;
+  s.lastChunk = data;
 }
 
 function start(sessions, broadcast) {
@@ -43,6 +47,15 @@ function start(sessions, broadcast) {
       stats[id] = { rawRateOut, rawRateIn, burstMs };
     }
     if (Object.keys(stats).length) broadcast({ type: 'stats', stats });
+    // Debug: PTY active state + last output chars per session (1s tick)
+    const active = [];
+    for (const [id] of sessions) {
+      const s = stream[id]; if (!s?.lastOutAt) continue;
+      const state = now - s.lastOutAt < 2000 ? 'ACTIVE' : 'SILENT';
+      const last = (s.lastChunk || '').replace(/\x1b\[[0-9;?]*[ -/]*[@-~]|\x1b\].*?(?:\x07|\x1b\\)|\x1b./g, '').replace(/[\r\n]+/g, ' ').trim().slice(-80);
+      active.push(`${id.slice(0,8)}=${state} [${last}]`);
+    }
+    // if (active.length) console.log(`[pty] ${active.join(' | ')}`);
   }, 1000);
 }
 
@@ -57,7 +70,8 @@ function isActive(id) {
 }
 
 function lastOutputAt(id) { return stream[id]?.lastOutAt || 0; }
+function lastChunk(id) { return stream[id]?.lastChunk || ''; }
 
 function clear(id) { delete net[id]; delete stream[id]; }
 
-module.exports = { start, stop, trackIn, trackOut, isActive, lastOutputAt, clear };
+module.exports = { start, stop, trackIn, trackOut, isActive, lastOutputAt, lastInputAt, lastChunk, clear };

package/config.js

@@ -6,6 +6,71 @@ const { defaultShell, binName } = require('./utils');
 
 const CONFIG_PATH = join(DATA_DIR, 'config.json');
 
+const STARTER_PROMPTS = [
+  {
+    id: 'starter-prompt-update-documentation',
+    name: 'Update documentation',
+    text: 'Our docs needs to be updated based on the latest diff changes. Please review the latest changes and udpate the docs accordingly. List the changes you did in concise points in your response. Thanks.',
+  },
+  {
+    id: 'starter-prompt-investigate-codebase',
+    name: 'Investigate codebase',
+    text: `Learn the codebase and investigate it for:
+- Critical issues
+- Serious logical issues
+- Things you dont understand why they are there
+- Redundent code
+- Ugly workarounds / plasters / band-aids
+
+list your fidings please.`,
+  },
+  {
+    id: 'starter-prompt-reviewer-findings',
+    name: 'Reviewer findings',
+    text: 'Here are the reviewer findings, if you find that any are valid and relevant, please fix with pure solutions, simple approaches, never apply workarounds / plasters.\nWhen finish, list what you fix and how:',
+  },
+];
+
+const STARTER_ROLES = [
+  {
+    id: 'starter-role-programmer',
+    name: 'Programmer',
+    instructions: `You are the main programmer of this project.
+Do you not apply workarounds or bandaids, prefer pure solutions.
+NEVER use plan tool/mode, start to build immediatly and ask questions along the way if any.
+Check if any external findings are valid before applying changes, the reviewer doesnt always updated with the full scope.
+When you done with changes, list concisely what you did.
+
+Learn the project quickly if exist. Go over the structure, code and functionality.
+Let me know when you are ready.`,
+  },
+  {
+    id: 'starter-role-reviewer',
+    name: 'Reviewer',
+    instructions: `You are the code reviewer in this project.
+Your task is check the coder output and list critical / logical design flow issues, ugly workarounds or functionalty you just dont understand why its there. Do not waste time and list insignificunt findings.
+
+If you didnt find anything, response with no findings.
+
+You never write code!.
+
+Quickly learn the project if exist. Go over the structure, code and functionality and let me know when you are ready.`,
+  },
+  {
+    id: 'starter-role-product-manager',
+    name: 'Product manager',
+    instructions: `You are the product manager of this project, you should understand why we do what we do and what is the best way to do it. You dont care about technical limitations or directions, the only thing matter to you is the user UI/UX and how this agents team will ship a top notch, professional deliveries.
+Do not allow the team to round angles and skip small stuff that will basly impact the user.
+
+You never write code!
+You dont use your plan tool/mode - instead you are planning immediatly as you go.
+
+Go over the project if exist and understand from the code, documentations and readme what is it and why we do it.
+
+Let me know when you are ready`,
+  },
+];
+
 const DEFAULTS = {
   defaultPath: join(os.homedir(), 'Documents'),
   commands: [
@@ -20,6 +85,7 @@ const DEFAULTS = {
   defaultTheme: 'catppuccin-mocha',
   defaultShell,
   prompts: [],
+  roles: [],
   projects: [],
 };
 
@@ -81,11 +147,18 @@ function migrate(cfg) {
     }
   }
   if (!cfg.projects) cfg.projects = [];
+  if (!cfg.roles) cfg.roles = [];
   return cfg;
 }
 
 function load() {
-  if (!existsSync(CONFIG_PATH)) return deepCopy(DEFAULTS);
+  if (!existsSync(CONFIG_PATH)) {
+    return {
+      ...deepCopy(DEFAULTS),
+      prompts: deepCopy(STARTER_PROMPTS),
+      roles: deepCopy(STARTER_ROLES),
+    };
+  }
   try {
     return migrate({ ...deepCopy(DEFAULTS), ...JSON.parse(readFileSync(CONFIG_PATH, 'utf8')) });
   } catch { return deepCopy(DEFAULTS); }

package/handlers.js

@@ -117,6 +117,7 @@ function onConnection(ws) {
   ws.send(JSON.stringify({ type: 'sessions.resumable', list: sessions.getResumable(cfg) }));
   ws.send(JSON.stringify({ type: 'transcript.cache', cache: transcript.getCache() }));
   ws.send(JSON.stringify({ type: 'plugins', list: plugins.getInfo() }));
+  ws.send(JSON.stringify({ type: 'pills', list: plugins.getPills() }));
   sessions.sendBuffers(ws);
 
   ws.on('message', (raw) => {
@@ -130,8 +131,7 @@ function onConnection(ws) {
       case 'input':                sessions.input(msg); break;
       case 'session.statusReport':
         if (sessions.getSessions().has(msg.id)) {
-          sessions.broadcast({ type: 'session.status', id: msg.id, working: !!msg.working });
-          plugins.notifyStatus(msg.id, !!msg.working);
+          sessions.broadcast({ type: 'session.status', id: msg.id, working: !!msg.working, source: 'client' });
         }
         break;
       case 'terminal.buffer': {
@@ -140,11 +140,18 @@ function onConnection(ws) {
         const sess = sessions.getSessions().get(msg.id);
         if (sess) {
           const choices = require('./transcript').detectMenu(msg.lines, sess.presetId);
+          // Auto-approve: send Enter immediately when menu detected
+          if (choices && plugins.shouldAutoApproveMenu(msg.id)) {
+            sessions.input({ id: msg.id, data: '\r' });
+          }
           const key = choices ? JSON.stringify(choices) : '';
           if (key !== (sess._menuKey || '')) {
             sess._menuKey = key;
             sessions.broadcast({ type: 'session.menu', id: msg.id, choices: choices || [] });
-            if (choices) sessions.broadcast({ type: 'session.status', id: msg.id, working: false, source: 'menu' });
+            if (choices) {
+              plugins.notifyMenu(msg.id, choices);
+              sessions.broadcast({ type: 'session.status', id: msg.id, working: false, source: 'menu' });
+            }
           }
         }
         break;
@@ -262,13 +269,29 @@ function onConnection(ws) {
 
       case 'dirs.list': {
         const target = msg.path || cfg.defaultPath;
-        const result = listDirs(target);
+        const result = listDirs(target, !!msg.showHidden);
         const entries = Array.isArray(result) ? result : [];
         const error = result.error || undefined;
         ws.send(JSON.stringify({ type: 'dirs', path: target, entries, error }));
         break;
       }
 
+      case 'dirs.mkdir': {
+        const name = (msg.name || '').trim();
+        if (!name || name.includes('/') || name.includes('\\') || name === '.' || name === '..') {
+          ws.send(JSON.stringify({ type: 'dirs.mkdir', success: false, error: 'Invalid folder name' }));
+          break;
+        }
+        const dirPath = join(msg.parent, name);
+        try {
+          mkdirSync(dirPath);
+          ws.send(JSON.stringify({ type: 'dirs.mkdir', success: true, path: dirPath }));
+        } catch (e) {
+          ws.send(JSON.stringify({ type: 'dirs.mkdir', success: false, error: e.message }));
+        }
+        break;
+      }
+
       case 'plugin.settings.update':
         plugins.updateSetting(msg.pluginId, msg.key, msg.value);
         sessions.broadcast({ type: 'plugins', list: plugins.getInfo() });
@@ -284,6 +307,10 @@ function onConnection(ws) {
         break;
       }
 
+      case 'pill.getLogs':
+        ws.send(JSON.stringify({ type: 'pill.logs', id: msg.id, logs: plugins.getPillLogs(msg.id) }));
+        break;
+
       case 'remote.status': {
         let installed = false;
         try { execFileSync(whichCmd, ['clideck-remote'], { stdio: 'ignore' }); installed = true; } catch {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clideck",
-  "version": "1.26.0",
+  "version": "1.26.3",
   "description": "One screen for all your AI coding agents — run, monitor, and manage multiple CLI agents from a single browser tab",
   "main": "server.js",
   "bin": {
@@ -33,6 +33,7 @@
   },
   "homepage": "https://clideck.dev/",
   "dependencies": {
+    "@mariozechner/pi-ai": "^0.62.0",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",
     "node-pty": "^1.1.0",

package/plugin-loader.js

@@ -1,6 +1,7 @@
 const { readdirSync, readFileSync, existsSync, mkdirSync, cpSync, rmSync } = require('fs');
 const { join, sep } = require('path');
 const { DATA_DIR } = require('./paths');
+const transcript = require('./transcript');
 
 const PLUGINS_DIR = join(DATA_DIR, 'plugins');
 mkdirSync(PLUGINS_DIR, { recursive: true });
@@ -33,16 +34,22 @@ const inputHooks = [];
 const outputHooks = [];
 const statusHooks = [];
 const transcriptHooks = [];
+const menuHooks = [];
 const sessionStatus = new Map(); // sessionId → boolean (dedup multi-client reports)
+const autoApproveMenus = new Set(); // sessionIds where menus should be auto-approved
 const frontendHandlers = new Map();
 let broadcastFn = null;
 let sessionsFn = null;
 let getConfigFn = null;
 let saveConfigFn = null;
+let inputFn = null;
+let createSessionFn = null;
+let closeSessionFn = null;
 const settingsChangeHandlers = new Map(); // pluginId → [fn]
+const sessionPills = new Map(); // pillId → { pluginId, id, title, projectId, working, statusText, icon, logs[] }
 
 function removeHooks(pluginId) {
-  for (const arr of [inputHooks, outputHooks, statusHooks, transcriptHooks]) {
+  for (const arr of [inputHooks, outputHooks, statusHooks, transcriptHooks, menuHooks]) {
     for (let i = arr.length - 1; i >= 0; i--) {
       if (arr[i].pluginId === pluginId) arr.splice(i, 1);
     }
@@ -51,13 +58,22 @@ function removeHooks(pluginId) {
     if (key.startsWith(`plugin.${pluginId}.`)) frontendHandlers.delete(key);
   }
   settingsChangeHandlers.delete(pluginId);
+  for (const [id, pill] of sessionPills) {
+    if (pill.pluginId === pluginId) {
+      sessionPills.delete(id);
+      broadcastFn?.({ type: 'pill.removed', id });
+    }
+  }
 }
 
-function init(broadcast, getSessions, getConfig, saveConfig) {
+function init(broadcast, getSessions, getConfig, saveConfig, sessionInput, createProgrammatic, closeSession) {
   broadcastFn = broadcast;
   sessionsFn = getSessions;
   getConfigFn = getConfig;
   saveConfigFn = saveConfig;
+  inputFn = sessionInput;
+  createSessionFn = createProgrammatic;
+  closeSessionFn = closeSession;
 
   for (const entry of readdirSync(PLUGINS_DIR, { withFileTypes: true })) {
     if (!entry.isDirectory()) continue;
@@ -88,7 +104,7 @@ function init(broadcast, getSessions, getConfig, saveConfig) {
       continue;
     }
 
-    const state = { manifest, dir, shutdownFns: [], actions: [] };
+    const state = { manifest, dir, shutdownFns: [], actions: [], dynamicOptions: {} };
     plugins.set(manifest.id, state);
 
     try {
@@ -113,6 +129,7 @@ function buildApi(pluginId, pluginDir, state) {
     onSessionOutput(fn) { outputHooks.push({ pluginId, fn }); },
     onStatusChange(fn) { statusHooks.push({ pluginId, fn }); },
     onTranscriptEntry(fn) { transcriptHooks.push({ pluginId, fn }); },
+    onMenuDetected(fn) { menuHooks.push({ pluginId, fn }); },
 
     sendToFrontend(event, data = {}) {
       broadcastFn?.({ ...data, type: `plugin.${pluginId}.${event}` });
@@ -124,17 +141,69 @@ function buildApi(pluginId, pluginDir, state) {
     getSession(id) {
       const s = sessionsFn?.()?.get(id);
       if (!s) return null;
-      return { id, name: s.name, cwd: s.cwd, commandId: s.commandId, themeId: s.themeId, projectId: s.projectId };
+      return { id, name: s.name, cwd: s.cwd, commandId: s.commandId, presetId: s.presetId || 'shell', themeId: s.themeId, projectId: s.projectId, roleName: s.roleName || null, working: !!sessionStatus.get(id) };
     },
     getSessions() {
       const sessions = sessionsFn?.();
       if (!sessions) return [];
       return [...sessions].map(([id, s]) => ({
-        id, name: s.name, cwd: s.cwd, commandId: s.commandId, themeId: s.themeId, projectId: s.projectId,
+        id, name: s.name, cwd: s.cwd, commandId: s.commandId, presetId: s.presetId || 'shell', themeId: s.themeId, projectId: s.projectId, roleName: s.roleName || null, working: !!sessionStatus.get(id),
       }));
     },
 
+    createSession(opts) {
+      const cfg = getConfigFn?.();
+      if (!cfg || !createSessionFn) return null;
+      const result = createSessionFn(opts, cfg);
+      return result.error ? null : result.id;
+    },
+    closeSession(id) {
+      const cfg = getConfigFn?.();
+      if (!cfg || !closeSessionFn) return;
+      closeSessionFn({ id }, cfg);
+    },
+
+    inputToSession(id, data) { inputFn?.({ id, data }); },
+    setAutoApproveMenu(id, enabled) { enabled ? autoApproveMenus.add(id) : autoApproveMenus.delete(id); },
+
+    getRoles() { return JSON.parse(JSON.stringify(getConfigFn?.()?.roles || [])); },
+    getProjects() { return JSON.parse(JSON.stringify(getConfigFn?.()?.projects || [])); },
+    getTranscript(id, n) { return transcript.getLastTurns(id, n || 20); },
+    getScreenTurns(id, agent, opts) { return transcript.getScreenTurns(id, agent, opts); },
+    getScreen(id) { return transcript.getScreen(id); },
+    detectMenu(lines, presetId) { return transcript.detectMenu(lines, presetId); },
+
     addToolbarAction(opts) { state.actions.push({ ...opts, pluginId, slot: 'toolbar' }); },
+    addProjectAction(opts) { state.actions.push({ ...opts, pluginId, slot: 'project-header' }); },
+
+    addSessionPill(opts) {
+      const pill = { pluginId, id: opts.id, title: opts.title, projectId: opts.projectId, working: false, statusText: '', icon: opts.icon || '', logs: [], startedAt: Date.now() };
+      sessionPills.set(opts.id, pill);
+      broadcastFn?.({ type: 'pill.added', pill: pillInfo(pill) });
+    },
+    updateSessionPill(id, updates) {
+      const pill = sessionPills.get(id);
+      if (!pill || pill.pluginId !== pluginId) return;
+      if (updates.title !== undefined) pill.title = updates.title;
+      if (updates.working !== undefined) pill.working = updates.working;
+      if (updates.statusText !== undefined) pill.statusText = updates.statusText;
+      if (updates.projectId !== undefined) pill.projectId = updates.projectId;
+      broadcastFn?.({ type: 'pill.updated', pill: pillInfo(pill) });
+    },
+    appendPillLog(id, text) {
+      const pill = sessionPills.get(id);
+      if (!pill || pill.pluginId !== pluginId) return;
+      const entry = { ts: Date.now(), text };
+      pill.logs.push(entry);
+      if (pill.logs.length > 200) pill.logs.splice(0, pill.logs.length - 200);
+      broadcastFn?.({ type: 'pill.log', id, entry });
+    },
+    removeSessionPill(id) {
+      const pill = sessionPills.get(id);
+      if (!pill || pill.pluginId !== pluginId) return;
+      sessionPills.delete(id);
+      broadcastFn?.({ type: 'pill.removed', id });
+    },
 
     getSetting(key) {
       const cfg = getConfigFn?.();
@@ -153,6 +222,28 @@ function buildApi(pluginId, pluginDir, state) {
       settingsChangeHandlers.get(pluginId).push(fn);
     },
 
+    setSettingOptions(key, options) {
+      state.dynamicOptions[key] = options;
+      broadcastFn?.({ type: 'plugins', list: getInfo() });
+    },
+    setSetting(key, value) {
+      updateSetting(pluginId, key, value);
+      broadcastFn?.({ type: 'plugins', list: getInfo() });
+    },
+
+    resolve(specifier) {
+      // Resolve a package from the app's node_modules. Intended for bundled
+      // plugins that ship with CliDeck and can rely on app-level dependencies.
+      // Third-party plugins should bundle their own deps or be self-contained.
+      try { return require.resolve(specifier); } catch {}
+      const parts = specifier.startsWith('@') ? specifier.split('/').slice(0, 2) : [specifier.split('/')[0]];
+      const pkgDir = join(__dirname, 'node_modules', ...parts);
+      const pkg = JSON.parse(readFileSync(join(pkgDir, 'package.json'), 'utf8'));
+      const entry = typeof pkg.exports === 'string' ? pkg.exports
+        : pkg.exports?.['.']?.import || pkg.exports?.['.']?.default || pkg.exports?.['.']
+        || pkg.module || pkg.main || 'index.js';
+      return join(pkgDir, entry);
+    },
     onShutdown(fn) { state.shutdownFns.push(fn); },
     log(msg) { console.log(`[plugin:${pluginId}] ${msg}`); },
   };
@@ -177,11 +268,11 @@ function notifyOutput(id, data) {
   }
 }
 
-function notifyStatus(id, working) {
+function notifyStatus(id, working, source) {
   if (sessionStatus.get(id) === working) return;
   sessionStatus.set(id, working);
   for (const h of statusHooks) {
-    try { h.fn(id, working); }
+    try { h.fn(id, working, source); }
     catch (e) { console.error(`[plugin:${h.pluginId}] status error: ${e.message}`); }
   }
 }
@@ -193,6 +284,14 @@ function notifyTranscript(id, role, text) {
   }
 }
 
+function notifyMenu(id, choices) {
+  for (const h of menuHooks) {
+    try { h.fn(id, choices); }
+    catch (e) { console.error(`[plugin:${h.pluginId}] menu error: ${e.message}`); }
+  }
+}
+
+
 function updateSetting(pluginId, key, value) {
   // Validate plugin exists (also prevents __proto__ pollution — Map lookup returns undefined)
   const plugin = plugins.get(pluginId);
@@ -201,7 +300,8 @@ function updateSetting(pluginId, key, value) {
   const settingDef = (plugin.manifest.settings || []).find(s => s.key === key);
   if (!settingDef) return;
   // Type-coerce/validate value against manifest type
-  const coerced = coerceSetting(settingDef, value);
+  const dynOpts = settingDef.type === 'dynamic-select' ? plugin.dynamicOptions?.[key] : null;
+  const coerced = coerceSetting(settingDef, value, dynOpts);
   if (coerced === undefined) return;
 
   const cfg = getConfigFn?.();
@@ -217,7 +317,7 @@ function updateSetting(pluginId, key, value) {
   }
 }
 
-function coerceSetting(def, value) {
+function coerceSetting(def, value, dynOpts) {
   switch (def.type) {
     case 'toggle': return !!value;
     case 'number': {
@@ -232,6 +332,12 @@ function coerceSetting(def, value) {
       const s = String(value);
       return opts.includes(s) ? s : undefined;
     }
+    case 'dynamic-select': {
+      const s = String(value);
+      if (!dynOpts?.length) return s; // options not loaded yet — accept
+      const opts = dynOpts.map(o => String(typeof o === 'object' ? o.value : o));
+      return opts.includes(s) ? s : undefined;
+    }
     default: return String(value);
   }
 }
@@ -254,6 +360,7 @@ function getInfo() {
     description: p.manifest.description || '',
     settings: p.manifest.settings || [],
     settingValues: cfg?.pluginSettings?.[p.manifest.id] || {},
+    dynamicOptions: p.dynamicOptions || {},
     actions: p.actions,
     hasClient: existsSync(join(p.dir, 'client.js')),
     bundled: BUNDLED_IDS.has(p.manifest.id),
@@ -288,7 +395,16 @@ function shutdown() {
   }
 }
 
-function clearStatus(id) { sessionStatus.delete(id); }
+function pillInfo(pill) {
+  return { id: pill.id, pluginId: pill.pluginId, title: pill.title, projectId: pill.projectId, working: pill.working, statusText: pill.statusText, icon: pill.icon, startedAt: pill.startedAt };
+}
+
+function getPills() { return [...sessionPills.values()].map(pillInfo); }
+function getPillLogs(id) { return sessionPills.get(id)?.logs || []; }
+
+function clearStatus(id) { sessionStatus.delete(id); autoApproveMenus.delete(id); }
+function isWorking(id) { return !!sessionStatus.get(id); }
+function shouldAutoApproveMenu(id) { return autoApproveMenus.has(id); }
 
 // Bundled plugin IDs — these ship with CliDeck and must not be deleted
 const BUNDLED_IDS = new Set(
@@ -318,6 +434,7 @@ function removePlugin(pluginId) {
 module.exports = {
   PLUGINS_DIR, BUNDLED_IDS,
   init, shutdown,
-  transformInput, notifyOutput, notifyStatus, notifyTranscript, clearStatus,
+  transformInput, notifyOutput, notifyStatus, notifyTranscript, notifyMenu, clearStatus, isWorking, shouldAutoApproveMenu,
   handleMessage, updateSetting, getInfo, resolveFile, removePlugin,
+  getPills, getPillLogs,
 };

package/plugins/autopilot/clideck-plugin.json

@@ -0,0 +1,52 @@
+{
+  "id": "autopilot",
+  "name": "Autopilot",
+  "version": "0.14.4",
+  "author": "CliDeck",
+  "description": "Multi-agent orchestration — routes output between agents automatically",
+  "settings": [
+    {
+      "key": "enabled",
+      "label": "Enabled",
+      "type": "toggle",
+      "default": true
+    },
+    {
+      "key": "provider",
+      "label": "Provider",
+      "type": "select",
+      "default": "anthropic",
+      "options": [
+        { "value": "anthropic", "label": "Anthropic" },
+        { "value": "openai", "label": "OpenAI" },
+        { "value": "google", "label": "Google AI" },
+        { "value": "groq", "label": "Groq" },
+        { "value": "openrouter", "label": "OpenRouter" },
+        { "value": "xai", "label": "xAI" },
+        { "value": "mistral", "label": "Mistral" },
+        { "value": "cerebras", "label": "Cerebras" }
+      ]
+    },
+    {
+      "key": "model",
+      "label": "Model",
+      "type": "dynamic-select",
+      "default": "claude-haiku-4-5"
+    },
+    {
+      "key": "apiKey",
+      "label": "API Key",
+      "type": "text",
+      "default": "",
+      "placeholder": "Falls back to env var (ANTHROPIC_API_KEY, etc.)",
+      "description": "Leave empty to use the standard environment variable for the selected provider"
+    },
+    {
+      "key": "debugging",
+      "label": "Debugging",
+      "type": "toggle",
+      "default": false,
+      "description": "Save each router LLM turn (system prompt, KB history, agent outputs) to ~/.clideck/autopilot/logs/ for inspection"
+    }
+  ]
+}