claude-code-kanban 7.23.0 → 7.24.0

package/hub-app.json

@@ -7,7 +7,26 @@
   "publishes": ["session.changed"],
   "actions": {
     "handles": {
-      "session.open": { "params": { "session": "string" }, "mode": "message" }
+      "session.open": { "params": { "session": "string" }, "mode": "message" },
+      "session.find": { "params": { "name": "string?" }, "mode": "message" },
+      "session.paste": { "params": { "text": "string", "submit": "string?", "session": "string?" }, "mode": "message" },
+      "task.add": { "params": { "subject": "string?", "description": "string?" }, "mode": "message" },
+      "task.live": { "params": { "subject": "string?", "description": "string?", "pending": "string?", "final": "string?", "submit": "string?", "cancel": "string?" }, "mode": "message" },
+      "session.live": { "params": { "text": "string", "final": "string?", "submit": "string?", "cancel": "string?", "session": "string?" }, "mode": "message" },
+      "session.new": {
+        "params": {
+          "cwd": "string?",
+          "name": "string?",
+          "prompt": "string?",
+          "worktree": "string?",
+          "model": "string?",
+          "effort": "string?",
+          "args": "string?",
+          "edit": "string?",
+          "stay": "string?"
+        },
+        "mode": "message"
+      }
     }
   },
   "settings": [

package/lib/terminal-client.js

@@ -191,9 +191,14 @@ function createTerminalClient(o) {
     return call('end', id, providedToken);
   }
 
-  async function paste(id, text) {
+  async function paste(id, text, submit = false) {
     if (!isRunning(id)) return false;
-    return call('paste', id, text).catch(() => false);
+    return call('paste', id, text, submit).catch(() => false);
+  }
+
+  async function type(id, from, text, submit = false) {
+    if (!isRunning(id)) return false;
+    return call('type', id, from, text, submit).catch(() => false);
   }
 
   function restore() {
@@ -230,7 +235,7 @@ function createTerminalClient(o) {
   else spawn();
 
   return {
-    token, handleUpgrade, clientConfig, unavailableReason, authorized, isRunning, hasTerminal, sessionOfTerminal, startNew, end, paste, restore,
+    token, handleUpgrade, clientConfig, unavailableReason, authorized, isRunning, hasTerminal, sessionOfTerminal, startNew, end, paste, type, restore,
     setServerUrl, sessions, stats, shutdown, started,
     ids: () => [...ids],
     awaitingTrust: () => [...awaitingTrust],

package/lib/terminal-host.js

@@ -69,7 +69,8 @@ function init(msg) {
 const CALLS = {
   startNew: (msg, extraEnv) => service.startNew(msg, extraEnv),
   end: (id, token) => service.end(id, token),
-  paste: (id, text) => service.paste(id, text),
+  paste: (id, text, submit) => service.paste(id, text, submit),
+  type: (id, from, text, submit) => service.type(id, from, text, submit),
   restore: () => service.restore(),
   sessions: () => service.list(),
   claudePids: () => service.claudePids(),

package/lib/terminal.js

@@ -49,11 +49,14 @@ const OWNED_FLAGS = new Set([
 const MAX_PROMPT = 32 * 1024;
 const PROMPT_QUIET_MS = 400;
 const SUBMIT_POLL_MS = 1000;
+const SUBMIT_AFTER_PASTE_MS = 200;
 const SUBMIT_CHECKS = 5;
 const SUBMIT_RETRIES = 2;
 // The answer lines of Claude Code's folder-trust dialog, current and earlier wording. They tell the
-// board the dialog is up; the looser onTrustScreen only holds the prompt back, where a miss is worse.
+// board the dialog is up; the looser onDialogScreen only holds the prompt back, where a miss is worse.
 const TRUST_DIALOG = /Yes, I trust this folder|Do you trust the files in this folder\?/;
+// The footer of Claude Code's choice dialogs: folder trust, a new .mcp.json server and the rest.
+const DIALOG_SCREEN = /Enter to confirm/;
 // Watermarks from https://xtermjs.org/docs/guides/flowcontrol/ — pause the PTY while a
 // client lags, so a runaway process cannot grow the socket buffer without bound.
 const HIGH_WATER = 128 * 1024;
@@ -376,6 +379,7 @@ function createTerminalService(o) {
   const restoreGapMs = o.restoreGapMs ?? RESTORE_GAP_MS;
   const exitPollMs = o.exitPollMs ?? CLAUDE_EXIT_POLL_MS;
   const submitPollMs = o.submitPollMs ?? SUBMIT_POLL_MS;
+  const promptQuietMs = o.promptQuietMs ?? PROMPT_QUIET_MS;
   const pidAlive = o.isPidAlive || isPidAlive;
   const exitTimer = setInterval(checkExits, exitPollMs);
   exitTimer.unref();
@@ -505,8 +509,8 @@ function createTerminalService(o) {
   }
 
   // The folder and session names show on claude's main screen, so a "trust" in them is not the dialog.
-  function onTrustScreen(s) {
-    let text = screenText(s.term);
+  function onDialogScreen(s, text = screenText(s.term)) {
+    if (DIALOG_SCREEN.test(text)) return true;
     for (const own of [path.basename(s.cwd), s.name]) if (own) text = text.split(own).join('');
     return /\btrust\b/i.test(text);
   }
@@ -536,12 +540,13 @@ function createTerminalService(o) {
       if (!armed) return;
       timer = setTimeout(() => {
         if (s.exited) return;
-        if (submit && onTrustScreen(s)) return setAwaitingTrust(s, TRUST_DIALOG.test(screenText(s.term)));
+        const shown = submit && screenText(s.term);
+        if (submit && onDialogScreen(s, shown)) return setAwaitingTrust(s, TRUST_DIALOG.test(shown));
         setAwaitingTrust(s, false);
         s.onOutput = null;
         s.pty.write(text);
         if (submit) setTimeout(() => submitPrompt(s), 100);
-      }, PROMPT_QUIET_MS);
+      }, promptQuietMs);
     };
   }
 
@@ -938,16 +943,44 @@ function createTerminalService(o) {
     return r.error ? r : { id: r.session.id, cwd: r.session.cwd, name: r.session.name, prompted: r.session.prompted };
   }
 
-  // Pastes into claude's input box and stops there: Enter would also submit whatever the
-  // user had half-typed, and over a permission dialog it would answer it. A pending queued
-  // prompt owns the input box until it is sent.
-  function paste(id, text) {
+  // Pastes into claude's input box and stops there unless the caller asks for submit: Enter
+  // also submits whatever the user had half-typed. A dialog screen refuses the paste, so the
+  // Enter cannot answer one. A pending queued prompt owns the input box until it is sent.
+  function inputBox(id) {
     const s = sessions.get(id);
-    if (!s || s.ended || s.exited || s.claudeExitedAt || s.onOutput || s.mode === 'shell') return false;
-    if (onTrustScreen(s)) return false;
+    if (!s || s.ended || s.exited || s.claudeExitedAt || s.onOutput || s.mode === 'shell') return null;
+    // Not onDialogScreen: its loose "trust" test is for the first screen, and a conversation says trust.
+    const shown = screenText(s.term);
+    if (DIALOG_SCREEN.test(shown) || TRUST_DIALOG.test(shown)) return null;
     // Until the user runs the typed command, the input box is the shell's command line.
-    if (s.edit && !s.claudePid) return false;
+    if (s.edit && !s.claudePid) return null;
+    return s;
+  }
+
+  function paste(id, text, submit = false) {
+    const s = inputBox(id);
+    if (!s) return false;
     s.pty.write(bracketed(text));
+    // claude takes a paste and an Enter in the same read as a line break in the input box.
+    if (submit) setTimeout(() => !s.exited && s.pty.write('\r'), SUBMIT_AFTER_PASTE_MS);
+    return true;
+  }
+
+  // Live dictation: the caller typed `from` before and now wants `text`. Backspaces remove what
+  // differs and keys type the rest, so the input box follows the words as they come.
+  // Typed keys, not a paste: claude shows a long paste as one "[Pasted text]" chip that a backspace removes whole.
+  function type(id, from, text, submit = false) {
+    const s = inputBox(id);
+    if (!s) return false;
+    // A line break would be Enter.
+    const keysOf = (t) => Array.from(t.replace(/\s*[\r\n]+\s*/g, ' '));
+    const was = keysOf(from);
+    const now = keysOf(text);
+    let same = 0;
+    while (same < was.length && same < now.length && was[same] === now[same]) same++;
+    const keys = '\x7f'.repeat(was.length - same) + now.slice(same).join('');
+    if (keys) s.pty.write(keys);
+    if (submit) setTimeout(() => !s.exited && s.pty.write('\r'), keys ? SUBMIT_AFTER_PASTE_MS : 0);
     return true;
   }
 
@@ -967,7 +1000,7 @@ function createTerminalService(o) {
     sessions.clear();
   }
 
-  return { token, handleUpgrade, clientConfig, list, claudePids, isRunning, end, authorized, startNew, paste, restore, shutdown, unavailableReason };
+  return { token, handleUpgrade, clientConfig, list, claudePids, isRunning, end, authorized, startNew, paste, type, restore, shutdown, unavailableReason };
 }
 
-module.exports = { MODELS,createTerminalService, readTerminalConfig, localUnavailableReason, refuseUpgrade, clientConfigFor, ptyEnv, shellArgs, claudeCommand, resolveShell, claudeArgsFor, parseNewSpec, findPickProcess, tokenMatches };
+module.exports = { MODELS,createTerminalService, DIALOG_SCREEN, screenText, readTerminalConfig, localUnavailableReason, refuseUpgrade, clientConfigFor, ptyEnv, shellArgs, claudeCommand, resolveShell, claudeArgsFor, parseNewSpec, findPickProcess, tokenMatches };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-kanban",
-  "version": "7.23.0",
+  "version": "7.24.0",
   "description": "A web-based Kanban board for viewing Claude Code tasks with agent teams support",
   "main": "server.js",
   "type": "commonjs",
@@ -13,6 +13,7 @@
     "test": "node --test test/*.test.js",
     "test:swarm": "npm --prefix extensions/swarm/plugin/plugins/swarm test",
     "validate:schemas": "node test/validate-live-schemas.js",
+    "test:live-dialogs": "node test/live-startup-dialogs.js",
     "prepare": "husky"
   },
   "repository": {

package/public/app.js

@@ -4672,7 +4672,7 @@ function renderKanban() {
   // away mid-typing -- leave the column alone until the input is gone.
   if (!addingTask) {
     const addTile = canAddTask()
-      ? `<button type="button" class="column-add${pending.length ? '' : ' empty'}" onclick="startAddTask(this)" title="You can also ask the agent to add tasks with its TaskCreate tool. Make sure CLAUDE_CODE_ENABLE_TASKS is set in its environment.">${plusIcon}<span>Add task</span></button>`
+      ? `<button type="button" class="column-add${pending.length ? '' : ' empty'}" onclick="startAddTask(this, event)" title="Ctrl+Click opens the dialog with a description. You can also ask the agent to add tasks with its TaskCreate tool. Make sure CLAUDE_CODE_ENABLE_TASKS is set in its environment.">${plusIcon}<span>Add task</span></button>`
       : '';
     writes.push([
       pendingTasks,
@@ -4732,9 +4732,196 @@ function canAddTask() {
   return viewMode === 'session' && !!currentSessionId;
 }
 
+async function postTask(subject, description = '', sessionId = currentSessionId) {
+  const res = await api(apiPath`/api/tasks/${sessionId}`, { method: 'POST', body: { subject, description } });
+  if (!res.ok) throw new Error(`HTTP ${res.status}`);
+  // The response carries the finished task, and the watcher will resend it within the
+  // SSE debounce anyway -- so show it now rather than paying a session refetch for it.
+  const { task } = await res.json();
+  if (sessionId === currentSessionId) currentTasks.push({ ...task, sessionId });
+}
+
+// task.add from the hub: the subject goes on the board on screen; with none, the Add task dialog opens.
+async function addTaskFromHub({ subject, description }) {
+  if (!canAddTask()) return showToast('Open a session to add a task', 'info');
+  const text = subject?.trim();
+  if (!text) return openTaskDialog(true);
+  try {
+    await postTask(text, description?.trim());
+    if (!addingTask) renderKanban();
+  } catch (error) {
+    console.error('Failed to create task:', error);
+    showToast('Failed to create task', 'error');
+  }
+}
+
+// The Add task dialog: the hub opens it by voice and fills it as the user speaks. The task goes to
+// the session that was on screen when it opened.
+let taskDialogSession = null;
+const taskDialogOpen = () => document.getElementById('task-modal').classList.contains('visible');
+
+function openTaskDialog(focus = false) {
+  if (terminalPaneFocused()) leaveTerminalPane();
+  taskDialogSession = currentSessionId;
+  const session = sessions.find((s) => s.id === currentSessionId);
+  document.getElementById('task-modal-session').textContent = session ? sessionDisplayName(session) : '';
+  document.getElementById('task-subject').value = '';
+  document.getElementById('task-description').value = '';
+  setFormError('task-error', '');
+  renderTaskDialog();
+  document.getElementById('task-modal').classList.add('visible');
+  if (focus) document.getElementById('task-subject').focus();
+}
+
+function closeTaskDialog() {
+  hideModalOverlay('task-modal');
+  taskDialogSession = null;
+  taskDialogVoice = false;
+  setTaskVoiceState('');
+}
+
+function renderTaskDialog() {
+  const subject = document.getElementById('task-subject');
+  document.getElementById('task-save').disabled = subject.readOnly || !subject.value.trim();
+}
+
+function fillTaskDialog(subject, description) {
+  fillTaskField('task-subject', subject);
+  fillTaskField('task-description', description);
+  renderTaskDialog();
+}
+
+// Voice fills a field: it flashes, and a long text shows its newest words.
+function fillTaskField(id, value) {
+  const field = document.getElementById(id);
+  if (field.value === value) return;
+  field.value = value;
+  field.scrollTop = field.scrollHeight;
+  if (value) flashTaskField(field, 'task-filled');
+}
+
+function flashTaskField(field, cls) {
+  field.classList.remove('task-filled', 'task-moved');
+  void field.offsetWidth;
+  field.classList.add(cls);
+}
+
+async function saveTaskDialog() {
+  const subject = document.getElementById('task-subject').value.trim();
+  if (!subject || !taskDialogSession) return;
+  const save = document.getElementById('task-save');
+  save.disabled = true;
+  try {
+    await postTask(subject, document.getElementById('task-description').value.trim(), taskDialogSession);
+    closeTaskDialog();
+    if (!addingTask) renderKanban();
+  } catch (error) {
+    console.error('Failed to create task:', error);
+    setFormError('task-error', 'Failed to create task');
+    renderTaskDialog();
+  }
+}
+
+// The title can take a model call after the release; a quick answer shows no loading at all.
+const TASK_TITLING_DELAY_MS = 300;
+let taskTitlingTimer = null;
+
+// A hold fills a dialog: it glows, shows the badge, and its fields are read-only, so typing cannot
+// race the voice. A hold whose last call never comes (the hub page reloaded) runs `onStale` after
+// VOICE_STALE_MS, longer than a task title's model call.
+const VOICE_STALE_MS = 20_000;
+const voiceStale = new Map();
+
+function setModalVoice(modal, fields, state, onStale) {
+  clearTimeout(voiceStale.get(modal));
+  if (state) voiceStale.set(modal, setTimeout(onStale, VOICE_STALE_MS));
+  if ((modal.dataset.voice ?? '') === state) return;
+  if (state) modal.dataset.voice = state;
+  else delete modal.dataset.voice;
+  for (const field of fields) field.readOnly = !!state;
+  modal.querySelector('.voice-mic').hidden = !state;
+}
+
+// 'listening' while the user speaks, 'titling' while the title is on its way, '' when the dialog is
+// the user's.
+function setTaskVoiceState(state) {
+  clearTimeout(taskTitlingTimer);
+  if (state === 'titling') {
+    taskTitlingTimer = setTimeout(() => applyTaskVoiceState(state), TASK_TITLING_DELAY_MS);
+    return;
+  }
+  applyTaskVoiceState(state);
+}
+
+function applyTaskVoiceState(state) {
+  const subject = document.getElementById('task-subject');
+  const fields = [subject, document.getElementById('task-description')];
+  setModalVoice(document.querySelector('.task-modal'), fields, state, () => {
+    taskDialogVoice = false;
+    setTaskVoiceState('');
+  });
+  subject.classList.toggle('task-titling', state === 'titling');
+  subject.placeholder = state === 'titling' ? 'Writing a title…' : 'What to do';
+  document.getElementById('task-modal-mic-label').textContent = state === 'titling' ? 'Writing a title' : 'Listening';
+  renderTaskDialog();
+}
+
+// Set from a hold's first task.live until its last call or a close, so a final call that lands
+// after the user closed the dialog does not open it again.
+let taskDialogVoice = false;
+
+// task.live from the hub: while the user speaks, the words so far as the description; `pending` on
+// release; then `final` with the title and the description. A short task moves up into the title.
+function liveTaskFromHub(p) {
+  if (p.cancel === 'true') return taskDialogVoice && closeTaskDialog();
+  const last = p.final === 'true';
+  if (!taskDialogVoice && !last && p.pending !== 'true' && canAddTask()) {
+    if (!taskDialogOpen()) openTaskDialog();
+    taskDialogVoice = true;
+    setTaskVoiceState('listening');
+  }
+  if (!taskDialogVoice) return last && !canAddTask() && showToast('Open a session to add a task', 'info');
+  if (p.pending === 'true') return setTaskVoiceState('titling');
+  if (!last) {
+    setTaskVoiceState('listening');
+    return fillTaskField('task-description', p.description ?? '');
+  }
+  const subject = document.getElementById('task-subject');
+  taskDialogVoice = false;
+  setTaskVoiceState('');
+  if (p.subject !== undefined) {
+    const moved = !p.description && p.subject === document.getElementById('task-description').value.trim();
+    fillTaskDialog(p.subject, p.description ?? '');
+    if (moved) flashTaskField(subject, 'task-moved');
+  }
+  if (p.submit === 'true') return saveTaskDialog();
+  const save = document.getElementById('task-save');
+  (save.disabled ? subject : save).focus();
+}
+
+function initTaskDialog() {
+  const subject = document.getElementById('task-subject');
+  const description = document.getElementById('task-description');
+  subject.addEventListener('input', renderTaskDialog);
+  document.querySelector('.task-modal').addEventListener('keydown', (e) => {
+    if (e.key === 'Escape') {
+      e.preventDefault();
+      e.stopPropagation();
+      return closeTaskDialog();
+    }
+    if (e.key !== 'Enter' || e.shiftKey || e.isComposing) return;
+    if (e.target !== subject && e.target !== description) return;
+    e.preventDefault();
+    e.stopPropagation();
+    saveTaskDialog();
+  });
+}
+initTaskDialog();
+
 // biome-ignore lint/correctness/noUnusedVariables: used in HTML
-function startAddTask(tile) {
+function startAddTask(tile, e) {
   if (addingTask) return;
+  if (e?.ctrlKey || e?.metaKey) return openTaskDialog(true);
   addingTask = true;
 
   const input = document.createElement('input');
@@ -4761,14 +4948,8 @@ function startAddTask(tile) {
     const subject = input.value.trim();
     if (!subject) return reset();
     input.disabled = true;
-    const sessionId = currentSessionId;
     try {
-      const res = await api(apiPath`/api/tasks/${sessionId}`, { method: 'POST', body: { subject } });
-      if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      // The response carries the finished task, and the watcher will resend it within the
-      // SSE debounce anyway -- so show it now rather than paying a session refetch for it.
-      const { task } = await res.json();
-      currentTasks.push({ ...task, sessionId });
+      await postTask(subject);
       addingTask = false;
       renderKanban();
     } catch (error) {
@@ -7831,6 +8012,7 @@ const MODAL_CLOSERS = {
   'project-picker-modal': () => closeProjectPicker(),
   'terminal-manager-modal': () => closeTerminalManager(),
   'new-session-modal': () => closeNewSession(),
+  'task-modal': () => closeTaskDialog(),
   'confirm-modal': () => closeConfirmModal?.(false),
   'pane-pop': () => closePanePop(),
 };
@@ -12530,6 +12712,8 @@ let spPeekToken = 0;
 let spPeekedId = null;
 let spFromTerminal = false;
 let spRenderedQuery = null;
+// Rows ranked by the caller for the query the picker opened with; the first edit drops them.
+let spRanked = null;
 // Per-open cache: spSource is frozen while the picker is up, so a fetched log stays valid.
 const spPeekCache = new Map();
 // 'board' offers the sidebar's sessions plus a short tail of the newest others; 'all' offers
@@ -12583,10 +12767,11 @@ const spSearch = sessionSearch(() => {
   if (document.getElementById('session-picker-modal').classList.contains('visible')) renderSessionPicker();
 });
 
-function openSessionPicker() {
+function openSessionPicker({ query = '', ranked = null } = {}) {
   spFromTerminal = terminalPaneFocused();
   const input = document.getElementById('session-picker-input');
-  input.value = '';
+  input.value = query;
+  spRanked = ranked;
   spSource = getFilteredSessions().sort((a, b) => Date.parse(b.modifiedAt) - Date.parse(a.modifiedAt));
   spPeekCache.clear();
   spRenderedQuery = null;
@@ -12716,7 +12901,7 @@ function renderSessionPicker() {
   spRenderedQuery = renderKey;
   const all = spScope === 'all';
   const board = new Set(spSource.map((s) => s.id));
-  const local = (all ? spRecent.rows : spSource).filter((s) => spMatches(s, query));
+  const local = spRanked && !all ? spRanked : (all ? spRecent.rows : spSource).filter((s) => spMatches(s, query));
   const found = spSearch.rows(query, local);
   const tail = !all && !query ? spRecent.rows.filter((s) => !board.has(s.id)).slice(0, SP_RECENT_TAIL) : [];
   const extra = [...found.rows, ...tail];
@@ -12780,7 +12965,10 @@ async function spOpen(idx) {
 
 function initSessionPicker() {
   const input = document.getElementById('session-picker-input');
-  input.addEventListener('input', renderSessionPicker);
+  input.addEventListener('input', () => {
+    spRanked = null;
+    renderSessionPicker();
+  });
   // Bound on the input: the global handler returns early on INPUT targets.
   input.addEventListener('keydown', (e) => {
     if (e.key === 'Escape') closeSessionPicker();
@@ -15264,6 +15452,7 @@ panePop.addEventListener('keydown', (e) => {
 const TERMINAL_TOKEN_KEY = 'terminal-token';
 const TERMINAL_TOKEN_RE = /^[0-9a-f]{64}$/;
 const TERMINAL_MODES_KEY = 'terminal-sessions';
+const TERMINAL_SEEN_KEY = 'terminal-seen-sessions';
 const TERMINAL_FONT_KEY = 'terminal-font-size';
 const TERMINAL_FONT_MIN = 8;
 const TERMINAL_FONT_MAX = 32;
@@ -15355,6 +15544,16 @@ function setTerminalMode(sessionId, on) {
   store.writeJson(TERMINAL_MODES_KEY, [...modes].slice(-50));
 }
 
+// A session started elsewhere (dispatch, another board) runs in a terminal this board never turned on,
+// so its first open shows the terminal. Later opens keep what the user chose.
+function defaultToTerminalOnFirstOpen(sessionId) {
+  if (!runningTerminals.has(sessionId)) return;
+  const seen = readStoredList(TERMINAL_SEEN_KEY);
+  if (seen.includes(sessionId)) return;
+  store.writeJson(TERMINAL_SEEN_KEY, [...seen, sessionId].slice(-200));
+  setTerminalMode(sessionId, true);
+}
+
 function wantsTerminal() {
   return viewMode === 'session' && wantsTerminalFor(currentSessionId);
 }
@@ -15543,6 +15742,7 @@ async function openSession(sessionId) {
   setSessionDismissed(sessionId, false);
   // Awaited only when missing, so opening a loaded session stays synchronous up to fetchTasks.
   if (!sessions.some((s) => s.id === sessionId)) await ensureSessionLoaded(sessionId);
+  defaultToTerminalOnFirstOpen(sessionId);
   const alreadyOpen = sessionId === currentSessionId && viewMode === 'session' && termState.shown;
   if (!alreadyOpen) termState.openedByUser = sessionId;
   else if (termState.attached && promptAwaitsUser(sessionId)) focusTerminalPane();
@@ -16121,6 +16321,7 @@ async function openTerminal(sessionId, mode, attempt = 0) {
         effort: spec.effort,
         prompt: spec.prompt,
         edit: spec.edit,
+        extraArgs: spec.extraArgs,
         forkOf: spec.forkOf,
       }),
     },
@@ -17574,8 +17775,10 @@ function dockOnScreen(active = dockActivePane()) {
 function setDockAddon(id) {
   const tid = showState.terminalId;
   if (!tid || (dockAddons[tid] ?? null) === id) return;
-  if (id) dockAddons[tid] = id;
-  else delete dockAddons[tid];
+  if (id) {
+    dockAddons[tid] = id;
+    showState.closed = true;
+  } else delete dockAddons[tid];
   store.writeJson(DOCK_ADDON_KEY, dockAddons);
 }
 
@@ -18083,7 +18286,17 @@ const newSpecs = new Map();
 // Sessions another session started (`dispatch start`), shown where they will stay until
 // their transcript appears. Kept apart from newSpecs: their prompt is already sent.
 const dispatchSpecs = new Map();
-const ns = { projects: [], picked: [], matches: [], idx: -1, folder: '', busy: false, resume: false, images: [] };
+const ns = {
+  projects: [],
+  picked: [],
+  matches: [],
+  idx: -1,
+  folder: '',
+  busy: false,
+  resume: false,
+  images: [],
+  extraArgs: [],
+};
 // Must match ATTACHMENT_TYPES and the upload limit in server.js.
 const NS_IMAGE_TYPES = ['image/png', 'image/jpeg', 'image/gif', 'image/webp'];
 const NS_IMAGE_MAX_BYTES = 10 * 1024 * 1024;
@@ -18291,6 +18504,7 @@ function openNewSession(folder, resume = false) {
   if (!terminalAvailable() || document.getElementById('new-session-modal').classList.contains('visible')) return;
   if (terminalPaneFocused()) leaveTerminalPane();
   ns.resume = resume;
+  ns.extraArgs = [];
   document.querySelector('.new-session-modal').classList.toggle('ns-resume', resume);
   document.getElementById('ns-title').textContent = resume ? 'Resume session' : 'New session';
   for (const id of ['ns-name', 'ns-wt-name', 'ns-prompt']) document.getElementById(id).value = '';
@@ -18308,7 +18522,7 @@ function openNewSession(folder, resume = false) {
   const input = document.getElementById('ns-folder');
   input.focus();
   input.select();
-  loadProjects().then((list) => {
+  return loadProjects().then((list) => {
     ns.projects = list
       .filter((p) => !p.temp)
       .sort((a, b) => (b.modifiedAt || '').localeCompare(a.modifiedAt || ''))
@@ -18320,10 +18534,16 @@ function openNewSession(folder, resume = false) {
 
 function closeNewSession() {
   hideModalOverlay('new-session-modal');
+  setNewSessionVoice(false);
   closeFolderList();
   closeImagePreview();
   clearNewSessionImages();
   promptVoice.rec?.abort();
+  if (promptVoice.hub) {
+    promptVoice.hub = null;
+    document.getElementById('ns-mic').setAttribute('aria-pressed', 'false');
+    hub.invoke(HUB_DICTATE, { op: 'cancel' });
+  }
 }
 
 function addNewSessionImages(files) {
@@ -18478,6 +18698,7 @@ function newSessionValues() {
     prompt: document.getElementById('ns-prompt').value.trim() || null,
     edit,
     stay: !ns.resume && !edit && document.getElementById('ns-stay').checked,
+    extraArgs: ns.resume ? [] : ns.extraArgs,
   };
 }
 
@@ -18490,7 +18711,11 @@ function newSessionProblem(v) {
 }
 
 function setNewSessionError(text) {
-  const el = document.getElementById('ns-error');
+  setFormError('ns-error', text);
+}
+
+function setFormError(id, text) {
+  const el = document.getElementById(id);
   el.textContent = text;
   el.hidden = !text;
 }
@@ -18504,6 +18729,8 @@ function renderNewSessionForm() {
   hint.hidden = !wtOn;
   hint.textContent = `.claude/worktrees/${typeof v.worktree === 'string' ? v.worktree : '<name chosen by Claude>'}`;
   document.getElementById('ns-stay').disabled = v.edit;
+  document.getElementById('ns-args-row').hidden = !v.extraArgs.length;
+  document.getElementById('ns-args').textContent = v.extraArgs.join(' ');
   const problem = newSessionProblem(v);
   setNewSessionError(problem);
   const start = document.getElementById('ns-start');
@@ -18591,7 +18818,7 @@ function forkSession(parentId) {
 async function startNewSessionInBackground(id, v) {
   refreshPlaceholders();
   setNewSessionBusy(true);
-  const r = await newSessionPost('/api/terminal/start', { id, ...v }, 'Start failed');
+  const r = await newSessionPost('/api/terminal/start', { id, ...v, claudeArgs: v.extraArgs }, 'Start failed');
   setNewSessionBusy(false);
   if (r.error) {
     dropPlaceholder(id);
@@ -18609,26 +18836,34 @@ async function startNewSessionInBackground(id, v) {
 }
 
 const SpeechRecognitionApi = window.SpeechRecognition || window.webkitSpeechRecognition;
-const promptVoice = { rec: null };
+const promptVoice = { rec: null, hub: null };
+const HUB_DICTATE = 'voice.dictate';
 
 // Replaces the selection the field had when dictation began, so interim results rewrite
 // themselves in place instead of piling up.
-function togglePromptVoice() {
-  if (promptVoice.rec) return promptVoice.rec.stop();
+function promptInserter() {
   const field = document.getElementById('ns-prompt');
-  const btn = document.getElementById('ns-mic');
   const before = field.value.slice(0, field.selectionStart);
   const after = field.value.slice(field.selectionEnd);
   const lead = before && !/\s$/.test(before) ? ' ' : '';
-  const rec = new SpeechRecognitionApi();
-  rec.lang = navigator.language;
-  rec.interimResults = true;
-  rec.onresult = (e) => {
-    const text = Array.from(e.results, (r) => r[0].transcript).join('');
+  return (text) => {
     field.value = before + lead + text + after;
     const caret = before.length + lead.length + text.length;
     field.setSelectionRange(caret, caret);
+    renderNewSessionForm();
   };
+}
+
+function togglePromptVoice() {
+  if (hub.can(HUB_DICTATE)) return toggleHubDictation();
+  if (promptVoice.rec) return promptVoice.rec.stop();
+  const field = document.getElementById('ns-prompt');
+  const btn = document.getElementById('ns-mic');
+  const insert = promptInserter();
+  const rec = new SpeechRecognitionApi();
+  rec.lang = navigator.language;
+  rec.interimResults = true;
+  rec.onresult = (e) => insert(Array.from(e.results, (r) => r[0].transcript).join(''));
   rec.onerror = (e) => {
     if (e.error === 'not-allowed' || e.error === 'service-not-allowed')
       setNewSessionError('Microphone access is blocked for this page.');
@@ -18644,6 +18879,23 @@ function togglePromptVoice() {
   rec.start();
 }
 
+// Under a hub with voice on, the mic uses the hub's speech provider: the text arrives once, on the second click.
+async function toggleHubDictation() {
+  const btn = document.getElementById('ns-mic');
+  const op = promptVoice.hub ? 'stop' : 'start';
+  const insert = promptVoice.hub ?? promptInserter();
+  promptVoice.hub = op === 'start' ? insert : null;
+  btn.setAttribute('aria-pressed', String(op === 'start'));
+  document.getElementById('ns-prompt').focus();
+  const r = await hub.invoke(HUB_DICTATE, { op });
+  if (!r.ok) {
+    promptVoice.hub = null;
+    btn.setAttribute('aria-pressed', 'false');
+    return setNewSessionError(`Dictation failed: ${r.reason}`);
+  }
+  if (op === 'stop' && r.text) insert(r.text);
+}
+
 function pickFolderOption(i) {
   const path = ns.matches[i];
   if (!path) return;
@@ -19135,6 +19387,179 @@ hub.onActive((active) => {
 hub.onStatus(pushTerminalClaims);
 hub.onSettings(applyHubSettings);
 hub.handle('session.open', (p) => p.session && openSessionFromOutside(p.session));
+hub.handle('session.find', (p) => findSessionFromHub(p));
+hub.handle('session.paste', (p) => pasteFromHub(p));
+hub.handle('task.add', (p) => addTaskFromHub(p));
+hub.handle('task.live', (p) => liveTaskFromHub(p));
+// After pending session.live calls, so the hub's clear of words typed into the terminal lands there, not in the dialog.
+hub.handle('session.new', (p) => {
+  hubNewSession = liveChain.then(() => newSessionFromHub(p)).catch(() => {});
+});
+hub.handle('session.live', (p) => {
+  liveChain = liveChain.then(() => liveFromHub(p)).catch(() => {});
+});
+
+// Action params are strings, so flags come as "true" and `args` as claude args split on spaces
+// (the terminal refuses quotes in them anyway).
+function hubNewSessionValues(p) {
+  const onScreen = viewMode === 'session' ? sessions.find((s) => s.id === currentSessionId)?.project : null;
+  const filtered = filterProject && filterProject !== '__recent__' ? filterProject : null;
+  const wt = p.worktree?.trim();
+  const edit = p.edit === 'true';
+  return {
+    cwd: p.cwd || onScreen || filtered || '',
+    name: p.name?.trim() || null,
+    worktree: wt === 'true' ? true : wt && wt !== 'false' ? wt : false,
+    model: p.model || null,
+    effort: p.effort || null,
+    prompt: p.prompt?.trim() || null,
+    edit,
+    stay: !edit && p.stay === 'true',
+    extraArgs: p.args?.trim() ? p.args.trim().split(/\s+/) : [],
+  };
+}
+
+function newSessionFromHub(p) {
+  if (!terminalAvailable()) return showToast('The embedded terminal is off', 'error');
+  const v = hubNewSessionValues(p);
+  const problem = newSessionProblem(v);
+  if (problem) return showToast(problem, 'error');
+  return newSessionDialogFromHub(v);
+}
+
+// The dialog with the hub's values filled in, a folder picked (else the most recent project) and Start focused,
+// so the user sees what starts and one Enter starts it.
+async function newSessionDialogFromHub(v) {
+  const opened = openNewSession(v.cwd);
+  if (!opened) return;
+  const set = (id, value) => {
+    document.getElementById(id).value = value ?? '';
+  };
+  set('ns-name', v.name);
+  set('ns-prompt', v.prompt);
+  set('ns-model', v.model);
+  set('ns-effort', v.effort);
+  set('ns-wt-name', typeof v.worktree === 'string' ? v.worktree : '');
+  document.getElementById('ns-wt').checked = v.worktree !== false;
+  if (v.edit) document.getElementById('ns-edit').checked = true;
+  if (v.stay) document.getElementById('ns-stay').checked = true;
+  ns.extraArgs = v.extraArgs;
+  renderNewSessionForm();
+  await opened;
+  if (!ns.folder && ns.projects[0]) setNewSessionFolder(ns.projects[0]);
+  if (ns.folder) document.getElementById('ns-start').focus();
+}
+
+// session.find from the hub: spoken words name a session in the list. Each session scores the share
+// of the words found in its name, project and branch; a clear best opens at once, else a toast
+// offers the closest.
+const FIND_MIN_SCORE = 0.6;
+const FIND_MIN_LEAD = 0.25;
+const FIND_SKIP = new Set(['the', 'an', 'my', 'session', 'on', 'in', 'of', 'for', 'to', 'and', 'with', 'about']);
+const findWords = (s) =>
+  String(s ?? '')
+    .toLowerCase()
+    .split(/[^\p{L}\p{N}]+/u)
+    .filter((w) => w.length > 1 && !FIND_SKIP.has(w));
+// Speech drops or adds endings ("test" for "tests"), so words of 4+ letters match on a shared start.
+const wordFound = (w, words) =>
+  words.some((x) => x === w || (Math.min(x.length, w.length) >= 4 && (x.startsWith(w) || w.startsWith(x))));
+
+function rankSessions(name) {
+  const said = findWords(name);
+  if (!said.length) return [];
+  return sessions
+    .filter((s) => !s.placeholder)
+    .map((s) => {
+      const words = findWords(
+        `${sessionDisplayName(s)} ${s.project ? pathBasename(s.project) : ''} ${s.gitBranch ?? ''}`,
+      );
+      return { s, score: said.filter((w) => wordFound(w, words)).length / said.length };
+    })
+    .filter((r) => r.score > 0)
+    .sort((a, b) => b.score - a.score || Date.parse(b.s.modifiedAt) - Date.parse(a.s.modifiedAt));
+}
+
+function findSessionFromHub({ name }) {
+  const ranked = rankSessions(name ?? '');
+  const [best, next] = ranked;
+  if (best && best.score >= FIND_MIN_SCORE && (!next || best.score - next.score >= FIND_MIN_LEAD)) {
+    return revealSession(best.s.id);
+  }
+  if (isSessionPickerOpen()) closeSessionPicker({ refocus: false });
+  openSessionPicker({ query: name?.trim() ?? '', ranked: ranked.length ? ranked.map((r) => r.s) : null });
+}
+
+// Voice while the New session dialog is open is dictation into its prompt; Enter on Start sends it.
+function voiceIntoNewSession(text) {
+  promptInserter()(text.trim());
+  if (ns.folder) document.getElementById('ns-start').focus();
+}
+
+// The hub's voice control sends dictated text here; with no session named, it goes to the one on screen.
+const newSessionOpen = () => document.getElementById('new-session-modal').classList.contains('visible');
+const hubTargetSession = (session) => session || (viewMode === 'session' && termState.shown && termState.sessionId);
+const noSessionToast = (text) =>
+  showToast('No session on screen', 'info', { label: 'Copy', onClick: () => copyText(text, 'text') }, text);
+
+async function pasteFromHub({ session, text, submit }) {
+  if (!text) return;
+  if (!session && newSessionOpen()) return voiceIntoNewSession(text);
+  const id = hubTargetSession(session);
+  if (!id) return noSessionToast(text);
+  const res = await terminalFetch(`/api/terminal/paste/${encodeURIComponent(id)}`, 'POST', {
+    text,
+    submit: submit === 'true',
+  });
+  if (!res.ok) showToast((await res.json().catch(() => ({}))).error || `Paste failed (${res.status})`, 'error');
+}
+
+// session.live: one key hold sends the words so far many times, then once with final. Calls run in
+// order, after a session.new sent just before them has opened its dialog.
+let hubNewSession = Promise.resolve();
+let liveChain = Promise.resolve();
+let liveText = { insert: null, typed: '', at: 0 };
+// A hold sends text about once a second, so a longer gap means the last hold ended without its
+// final call (the hub page reloaded) and its typed words are not this hold's to erase.
+const LIVE_GAP_MS = 10_000;
+
+function setNewSessionVoice(on) {
+  const modal = document.querySelector('.new-session-modal');
+  setModalVoice(modal, [document.getElementById('ns-prompt')], on ? 'listening' : '', () => setNewSessionVoice(false));
+}
+
+// `cancel` comes with an empty final text, which removes what the hold typed; "close" also closes
+// the New session dialog that the hold opened.
+async function liveFromHub({ session, text, final, submit, cancel }) {
+  await hubNewSession;
+  const done = final === 'true';
+  if (Date.now() - liveText.at > LIVE_GAP_MS) liveText = { insert: null, typed: '', at: 0 };
+  liveText.at = Date.now();
+  const hold = liveText;
+  if (done) liveText = { insert: null, typed: '', at: 0 };
+  if (!session && newSessionOpen()) {
+    hold.insert ??= promptInserter();
+    hold.insert(text.trim());
+    const prompt = document.getElementById('ns-prompt');
+    prompt.scrollTop = prompt.scrollHeight;
+    setNewSessionVoice(!done);
+    if (cancel === 'close') closeNewSession();
+    else if (done && !cancel && ns.folder) document.getElementById('ns-start').focus();
+    return;
+  }
+  const id = hubTargetSession(session);
+  if (!id) {
+    if (done && text) noSessionToast(text);
+    return;
+  }
+  const res = await terminalFetch(`/api/terminal/type/${encodeURIComponent(id)}`, 'POST', {
+    from: hold.typed,
+    text,
+    submit: done && submit === 'true',
+  });
+  if (res.ok) hold.typed = text;
+  else if (done) showToast((await res.json().catch(() => ({}))).error || `Typing failed (${res.status})`, 'error');
+}
 
 // session.changed goes out once the switch settles, so arrowing through the list sends one event.
 let publishTimer = 0;

package/public/index.html

@@ -814,6 +814,10 @@
     <div class="modal new-session-modal" onclick="event.stopPropagation()" role="dialog" aria-labelledby="ns-title">
       <div class="modal-header">
         <h3 class="modal-title" id="ns-title">New session</h3>
+        <span id="ns-voice" class="voice-mic" role="status" hidden>
+          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="2" width="6" height="12" rx="3"/><path d="M5 10a7 7 0 0 0 14 0M12 17v5"/></svg>
+          <span>Listening</span>
+        </span>
         <button class="modal-close" aria-label="Close dialog" onclick="closeNewSession()">
           <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M18 6L6 18M6 6l12 12"/></svg>
         </button>
@@ -883,6 +887,10 @@
             </div>
           </div>
         </div>
+        <div id="ns-args-row" class="ns-row" hidden>
+          <span class="ns-label">Args</span>
+          <div class="ns-field"><code id="ns-args" class="ns-hint" title="Claude arguments this session starts with"></code></div>
+        </div>
         <div id="ns-error" class="ns-error" hidden></div>
       </div>
       <div class="modal-footer ns-footer">
@@ -895,6 +903,41 @@
     </div>
   </div>
 
+  <div id="task-modal" class="modal-overlay top-aligned" onclick="closeTaskDialog()">
+    <div class="modal task-modal" onclick="event.stopPropagation()" role="dialog" aria-labelledby="task-modal-title">
+      <div class="modal-header">
+        <h3 class="modal-title" id="task-modal-title">Add task <span id="task-modal-session" class="task-modal-session"></span></h3>
+        <span id="task-modal-mic" class="voice-mic" role="status" hidden>
+          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="2" width="6" height="12" rx="3"/><path d="M5 10a7 7 0 0 0 14 0M12 17v5"/></svg>
+          <span id="task-modal-mic-label">Listening</span>
+        </span>
+        <button class="modal-close" aria-label="Close dialog" onclick="closeTaskDialog()">
+          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M18 6L6 18M6 6l12 12"/></svg>
+        </button>
+      </div>
+      <div class="modal-body ns-body">
+        <div class="ns-row">
+          <label class="ns-label" for="task-subject">Title</label>
+          <div class="ns-field">
+            <input type="text" id="task-subject" class="form-input" placeholder="What to do" autocomplete="off" data-bwignore data-1p-ignore data-lpignore="true">
+          </div>
+        </div>
+        <div class="ns-row">
+          <label class="ns-label" for="task-description">Description</label>
+          <div class="ns-field">
+            <textarea id="task-description" class="form-input" rows="4" placeholder="Optional"></textarea>
+          </div>
+        </div>
+        <div id="task-error" class="ns-error" hidden></div>
+      </div>
+      <div class="modal-footer ns-footer">
+        <span class="task-modal-hint"><kbd>Enter</kbd> adds &middot; <kbd>Shift</kbd>+<kbd>Enter</kbd> new line</span>
+        <button type="button" class="btn btn-secondary" onclick="closeTaskDialog()">Cancel</button>
+        <button type="button" id="task-save" class="btn btn-primary" onclick="saveTaskDialog()" disabled>Add</button>
+      </div>
+    </div>
+  </div>
+
   <div id="pane-pop" class="modal-overlay" onclick="closePanePop()">
     <div class="modal pane-pop-dialog" role="dialog" aria-labelledby="pane-pop-title" onclick="event.stopPropagation()">
       <div class="modal-header">

package/public/style.css

@@ -8675,7 +8675,8 @@ body.light .msg-assistant .msg-text {
   color: var(--text-muted);
 }
 
-.confirm-hint kbd {
+.confirm-hint kbd,
+.task-modal-hint kbd {
   font-family: var(--mono);
   font-size: 10px;
   border: 1px solid var(--border);
@@ -9623,6 +9624,10 @@ select.form-input option:checked {
   gap: 12px;
 }
 
+.ns-row[hidden] {
+  display: none;
+}
+
 .new-session-modal.ns-resume .ns-extra {
   display: none;
 }
@@ -9797,7 +9802,9 @@ select.form-input option:checked {
 }
 
 .ns-body textarea.form-input {
-  min-height: 0;
+  field-sizing: content;
+  min-height: 86px;
+  max-height: 50vh;
 }
 
 .ns-prompt-field {
@@ -9977,6 +9984,132 @@ select.form-input option:checked {
 }
 /* #endregion */
 
+/* #region TASK_DIALOG */
+.modal.task-modal {
+  width: 560px;
+  max-width: calc(100vw - 32px);
+}
+
+.task-modal-session {
+  margin-left: 6px;
+  font-size: 12px;
+  font-weight: 400;
+  color: var(--text-tertiary);
+}
+
+.task-modal .ns-label {
+  white-space: nowrap;
+}
+
+.modal[data-voice] {
+  border-color: color-mix(in srgb, var(--accent) 60%, var(--border));
+  animation: voice-glow 1.6s ease-in-out infinite;
+}
+
+@keyframes voice-glow {
+  0%,
+  100% {
+    box-shadow:
+      0 0 0 1px color-mix(in srgb, var(--accent) 35%, transparent),
+      0 0 18px color-mix(in srgb, var(--accent) 18%, transparent);
+  }
+  50% {
+    box-shadow:
+      0 0 0 1px color-mix(in srgb, var(--accent) 60%, transparent),
+      0 0 34px color-mix(in srgb, var(--accent) 35%, transparent);
+  }
+}
+
+.voice-mic {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  margin-left: auto;
+  margin-right: 8px;
+  padding: 3px 10px 3px 8px;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--accent) 14%, transparent);
+  color: var(--accent);
+  font-size: 12px;
+  font-weight: 500;
+}
+
+.voice-mic[hidden] {
+  display: none;
+}
+
+.voice-mic svg {
+  width: 14px;
+  height: 14px;
+  animation: voice-mic 1.2s ease-in-out infinite;
+}
+
+@keyframes voice-mic {
+  50% {
+    opacity: 0.4;
+  }
+}
+
+.modal[data-voice] .form-input[readonly] {
+  cursor: default;
+}
+
+.task-modal-hint {
+  margin-right: auto;
+  font-size: 11px;
+  color: var(--text-muted);
+}
+
+.task-modal .form-input.task-filled {
+  animation: task-filled 0.6s ease-out;
+}
+
+@keyframes task-filled {
+  from {
+    border-color: var(--accent);
+    box-shadow: 0 0 0 3px color-mix(in srgb, var(--accent) 25%, transparent);
+  }
+}
+
+.task-modal .form-input.task-moved {
+  animation: task-moved 0.35s ease-out;
+}
+
+@keyframes task-moved {
+  from {
+    opacity: 0.2;
+    transform: translateY(48px);
+  }
+}
+
+.task-modal .form-input.task-titling {
+  background:
+    linear-gradient(90deg, transparent 0%, color-mix(in srgb, var(--accent) 14%, transparent) 50%, transparent 100%) 0 0
+    / 200% 100% var(--bg-elevated);
+  animation: task-titling 1.2s linear infinite;
+  cursor: progress;
+}
+
+@keyframes task-titling {
+  from {
+    background-position: 100% 0;
+  }
+  to {
+    background-position: -100% 0;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .task-modal .form-input.task-filled,
+  .task-modal .form-input.task-moved,
+  .task-modal .form-input.task-titling,
+  .modal[data-voice],
+  .voice-mic svg {
+    animation: none;
+  }
+}
+/* #endregion */
+
 /* #region TOOL_STATS */
 .modal.tool-stats-modal {
   width: 90%;

package/public/vendor/claude-hub-sdk.js

@@ -1,4 +1,4 @@
-// claude-hub-sdk 1.8.0 (sha256 9a67dd2aa534). Copied by npm run sdk:sync in claude-code-hub. Do not edit.
+// claude-hub-sdk 1.9.0 (sha256 537745aa3415). Copied by npm run sdk:sync in claude-code-hub. Do not edit.
 // Claude Code Hub SDK: the one rule that names a key press, shared by the hub page, client.js and
 // stub.js. The hub serves it to its page as /sdk/keys.js; mount() and sdk:sync put it in front of
 // client.js and stub.js, so an app still loads one file.
@@ -18,7 +18,7 @@ var ClaudeHubKeys = (() => {
   function comboOf(e) {
     const lower = typeof e.key === 'string' ? e.key.toLowerCase() : '';
     const m = !e.getModifierState?.('AltGraph') && /^(?:Key|Digit)([A-Z1-9])$/.exec(e.code || '');
-    const key = /^[a-z1-9]$/.test(lower) ? lower : m ? m[1].toLowerCase() : e.key;
+    const key = /^[a-z1-9]$/.test(lower) ? lower : m ? m[1].toLowerCase() : e.key === ' ' ? 'Space' : e.key;
     const mods = [e.ctrlKey && 'ctrl', e.altKey && 'alt', e.shiftKey && 'shift', e.metaKey && 'meta'];
     return [...mods, key].filter(Boolean).join('+');
   }

package/server.js

@@ -1,5 +1,19 @@
 #!/usr/bin/env node
 
+if (process.argv.includes("--install") || process.argv.includes("--uninstall")) {
+  const { runInstall, runUninstall } = require("./install");
+  const yes = process.argv.includes("--yes");
+  (process.argv.includes("--install") ? runInstall({ yes }) : runUninstall())
+    .then(() => process.exit(0))
+    .catch(e => { console.error(e.message); process.exit(1); });
+} else if (!require("./cli").runCli(process.argv)) {
+  startServer();
+}
+
+// Not indented: the formatter is off for this file, and a reindent would rewrite every line.
+// The requires sit inside, so a CLI call does not load the server's modules.
+function startServer() {
+
 // #region SETUP
 const express = require('express');
 const path = require('node:path');
@@ -79,19 +93,6 @@ const { foldAgentLines } = require('./lib/agent-log');
 const { projectMatcher, normalizeProjectPath, sessionProjectKey } = require('./public/project-match');
 const { getParentVerdict, setParentVerdict, peekParentVerdict } = require('./lib/parent-cache');
 
-if (process.argv.includes("--install") || process.argv.includes("--uninstall")) {
-  const { runInstall, runUninstall } = require("./install");
-  const yes = process.argv.includes("--yes");
-  (process.argv.includes("--install") ? runInstall({ yes }) : runUninstall())
-    .then(() => process.exit(0))
-    .catch(e => { console.error(e.message); process.exit(1); });
-} else if (!require("./cli").runCli(process.argv)) {
-  startServer();
-}
-
-// Not indented: the formatter is off for this file, and a reindent would rewrite every line.
-function startServer() {
-
 const app = express();
 const PORT = parseInt(getArgValue('port') || process.env.PORT || '3541', 10);
 
@@ -3392,6 +3393,35 @@ app.post('/api/terminal/launched/:id', (req, res) => {
   res.status(204).end();
 });
 
+// The hub's session.paste action: text into a session's input box, with Enter when `submit`.
+// claude queues a prompt sent while it works. Refused (409) only on a dialog, where the keys would answer it:
+// the screen check misses a permission prompt with no "Enter to confirm", so the waiting marker is checked too.
+app.post('/api/terminal/paste/:id', terminalRoute(async (req, res) => {
+  if (!terminal.authorized(req.get('x-terminal-token'))) return res.status(401).json({ error: 'invalid terminal token' });
+  const { text, submit } = req.body || {};
+  if (typeof text !== 'string' || !text.trim()) return res.status(400).json({ error: 'text is required' });
+  const id = req.params.id;
+  if (!terminal.isRunning(id)) return res.status(404).json({ error: 'no running terminal for this session' });
+  if (isWaitingOnUser(id) || !(await terminal.paste(id, text, submit === true))) {
+    return res.status(409).json({ error: 'the session shows a dialog' });
+  }
+  res.status(204).end();
+}));
+
+// The hub's session.live action: dictated words typed into the input box as they come.
+// `from` is what the last call typed; the box loses what differs and gets the rest.
+app.post('/api/terminal/type/:id', terminalRoute(async (req, res) => {
+  if (!terminal.authorized(req.get('x-terminal-token'))) return res.status(401).json({ error: 'invalid terminal token' });
+  const { from = '', text, submit } = req.body || {};
+  if (typeof text !== 'string' || typeof from !== 'string') return res.status(400).json({ error: 'text is required' });
+  const id = req.params.id;
+  if (!terminal.isRunning(id)) return res.status(404).json({ error: 'no running terminal for this session' });
+  if (isWaitingOnUser(id) || !(await terminal.type(id, from, text, submit === true))) {
+    return res.status(409).json({ error: 'the session shows a dialog' });
+  }
+  res.status(204).end();
+}));
+
 // The New session dialog's "Stay here": the PTY starts headless and the board keeps its view.
 // `show` is `claude-code-kanban new` from a shell outside the board: a board tab adds its card
 // and attaches, and with no tab to claim it the PTY is ended, because no one would see it.