lazyclaw 3.99.21 → 3.99.23

package/README.md

@@ -111,6 +111,19 @@ Then `lazyclaw chat` (or any other entry point that ends up calling a provider
 
 Defaults fall back gracefully: `planner` defaults to `cfg.provider`/`cfg.model`, `workers` defaults to `[planner]` (single-agent chain, still benefits from plan + synthesis structure). Self-recursion (`planner: "orchestrator"`) is rejected up front.
 
+You can skip the JSON entirely and configure via `lazyclaw onboard` / `lazyclaw setup` (the picker lands on the orchestrator and walks you through a planner + workers wizard) **or** via the dedicated CLI:
+
+```bash
+lazyclaw orchestrator status
+lazyclaw orchestrator set-planner claude-cli:claude-opus-4-7
+lazyclaw orchestrator workers add openai:gpt-4o
+lazyclaw orchestrator workers add gemini:gemini-2.5-pro
+lazyclaw orchestrator workers set claude-cli:claude-sonnet-4-6,nim:meta/llama-3.1-405b-instruct   # bulk replace
+lazyclaw orchestrator set-max-subtasks 5
+lazyclaw orchestrator clear                                                                       # wipe cfg.orchestrator
+lazyclaw config set provider orchestrator                                                          # route chats through it
+```
+
 ## Launcher (no-arg `lazyclaw`)
 
 Running `lazyclaw` with no subcommand drops into an arrow-key launcher with every subcommand laid out as a menu. Navigation:

package/cli.mjs

@@ -914,6 +914,8 @@ const SUBCOMMANDS = [
   'auth', 'pairing', 'nodes', 'message', 'workspace', 'browse', 'cron',
   // v3.99.6 — multi-step setup wizard + lazyclaw-only dashboard
   'setup', 'dashboard',
+  // v3.99.22 — multi-agent orchestrator config
+  'orchestrator',
 ];
 
 const SUBCOMMAND_SUBS = {
@@ -929,6 +931,7 @@ const SUBCOMMAND_SUBS = {
   message:   ['list', 'add', 'remove', 'send'],
   workspace: ['list', 'init', 'show', 'remove', 'path'],
   cron:      ['list', 'add', 'remove', 'show', 'sync', 'run'],
+  orchestrator: ['status', 'set-planner', 'workers', 'set-max-subtasks', 'clear'],
 };
 
 function bashCompletion() {
@@ -1185,6 +1188,7 @@ const HELP_DETAILS = {
   cron: 'Usage: lazyclaw cron <list | add <name> "<cron-spec>" -- <cmd> ... | remove <name> | show <name> | sync | run <name>>\n  Schedule recurring agent runs. macOS uses launchd (~/Library/LaunchAgents/com.lazyclaw.<name>.plist); Linux / WSL uses the user crontab.\n  Cron spec is the standard 5-field form (minute hour dom month dow). Supports *, range a-b, list a,b,c, step */N.\n  add: pass the command after `--`. Typical use:\n      lazyclaw cron add daily-summary "0 9 * * 1-5" -- lazyclaw agent "Summarise today\'s TODOs"\n  list / show: read from cfg.cron[name] (config is the source of truth).\n  sync: re-installs every job in cfg.cron into the system scheduler — handy after a reinstall.\n  run: one-shot in-process execution of the named job; the OS scheduler does the same thing on its trigger.\n  Logs: ~/.lazyclaw/logs/cron-<name>.{out,err}.log (macOS launchd path).',
   setup: 'Usage: lazyclaw setup [--skip-test]\n  OpenClaw-style multi-step first-run wizard. Walks through:\n    1. Provider + model + api-key (delegates to onboard --pick)\n    2. Optional workspace init  (AGENTS.md / SOUL.md / TOOLS.md)\n    3. Optional skill bundle install from GitHub\n    4. Optional outbound webhook (Slack / Discord)\n    5. Reachability test against the picked provider\n  Each optional step takes Enter or "skip" to bypass. Re-runnable safely.\n  Also fires automatically on first run when `lazyclaw` is invoked with no config.',
   dashboard: 'Usage: lazyclaw dashboard [--port <N>] [--no-open]\n  Launches the lazyclaw-only web UI on http://127.0.0.1:<port> (default 19600) and opens it in the default browser.\n  Wraps `lazyclaw daemon` + a static HTML; no Python / lazyclaude dashboard required.\n  Tabs: Chat · Sessions · Skills · Workspace · Providers · Status. Each tab calls existing daemon endpoints.\n  --no-open keeps the browser closed (handy for SSH / headless / dev). The bound URL is always printed to stdout.',
+  orchestrator: 'Usage: lazyclaw orchestrator <status | set-planner <provider[:model]> | workers add <spec> | workers remove <spec> | workers set <spec,spec,...> | workers clear | set-max-subtasks <N> | clear>\n  Read/write cfg.orchestrator without editing config.json by hand.\n  status               — print {planner, workers, maxSubtasks} as JSON; lists registered providers for reference.\n  set-planner          — replace the planner spec ("provider" or "provider:model"). "orchestrator" itself is rejected (self-recursion).\n  workers add          — append a worker (idempotent — duplicates skipped).\n  workers remove       — drop a worker by exact match. Idempotent.\n  workers set          — replace the whole list (comma-separated specs).\n  workers clear        — empty the workers list.\n  set-max-subtasks <N> — cap subtasks per request, clamped 1..10 (default 5).\n  clear                — delete the cfg.orchestrator block entirely.\n  Pair with: `lazyclaw config set provider orchestrator` to route chats through it.',
 };
 
 function cmdHelp(name) {
@@ -1465,42 +1469,52 @@ function _attachGhostAutocomplete(rl) {
 // two of the inner lines were 33 cols vs the others' 32, so the
 // ╮ rendered into the next line).
 function _renderBanner(version) {
-  const W = 30;
-  const accent = (s) => `\x1b[38;5;208m${s}\x1b[0m`;
-  // 24-bit color so the mascot reads in the same warm orange as the
-  // dist/index.html SVG (#d97757). Falls back gracefully on terminals
-  // that ignore truecolor — the glyphs are visible regardless.
-  const orange = (s) => `\x1b[38;2;217;119;87m${s}\x1b[0m`;
-  // Inner content of each banner row — DO NOT pad here, the wrapper
-  // does it. Backslashes are JS-escaped so each `\\` renders as one
-  // literal `\` in the output.
-  const inner = [
-    '   _',
-    '  | |__ _ _____  _ _',
-    "  | / _` |_ / || | '_|",
-    '  |_\\__,_/__\\_, |_|',
-    '  LazyClaw  |__/  ' + String(version || '?.?.?').padEnd(10).slice(0, 10),
+  // Rebuilt from the Claude Design handoff bundle (v0.1 mascot sheet):
+  // Claude's asterisk star wearing a crab/crustacean helmet with two
+  // antenna-claws. 10-line "big ASCII" form — fits a terminal banner
+  // without zoom and reads at any monospace font that has the
+  // box-drawing + geometric-shape glyphs.
+  //
+  // Palette (CLAUDE ORIGINAL): helmet body #c33d2a, helmet shadow
+  // #7a1f15, star body #d97757, star shadow #a04f32, eyes ink
+  // #c7bca6 / muted slits. Truecolor ANSI; degrades gracefully on
+  // terminals that ignore it.
+  const helmet = (s) => `\x1b[38;2;195;61;42m${s}\x1b[0m`;   // #c33d2a
+  const star   = (s) => `\x1b[38;2;217;119;87m${s}\x1b[0m`;  // #d97757 — Claude orange
+  const ink    = (s) => `\x1b[38;2;241;234;217m${s}\x1b[0m`; // #f1ead9 paper-ink
+  const dim    = (s) => `\x1b[2m${s}\x1b[0m`;
+  const muted  = (s) => `\x1b[38;2;122;110;95m${s}\x1b[0m`;  // #7a6e5f
+
+  const v = String(version || '?.?.?');
+  // Left column — sprite. Right column — wordmark + tagline, aligned
+  // to the helmet's eye-row / brim. The trailing spaces preserve the
+  // grid so any caller padding the lines (or copying them) doesn't
+  // get ragged edges.
+  const left = [
+    `    ${helmet('▲')}      ${helmet('▲')}   `,
+    `    ${helmet('│')}      ${helmet('│')}   `,
+    `  ${helmet('╔══════════╗')} `,
+    `  ${helmet('║')}          ${helmet('║')} `,
+    `  ${helmet('║')}  ${muted('──')}  ${muted('──')}  ${helmet('║')} `,
+    `  ${helmet('║')}          ${helmet('║')} `,
+    `  ${helmet('╚══════════╝')} `,
+    `        ${star('✦')}       `,
+    `       ${star('╱|╲')}      `,
+    `      ${star('╱ | ╲')}     `,
   ];
-  // Pixel-art mascot mirrored from the lazyclaude SPA's #claudeMascot
-  // SVG (orange rectangles → block characters). Squashed to 5 rows so
-  // it lines up with `inner` in the banner. Eye sockets are left blank
-  // (the SVG fills them with #000); a hollow gap reads as eyes against
-  // the orange body in any monospace font.
-  const mascot = [
+  const right = [
+    '',
+    '',
+    '',
+    `   ${ink('lazyclaw')}  ${dim('v' + v)}`,
+    `   ${dim('a sleepy 8-bit')}`,
+    `   ${dim('terminal assistant')}`,
+    '',
+    '',
     '',
-    orange('   ██      ██'),
-    orange('  ██████████████'),
-    orange('  ██  ') + '██' + orange('  ') + '██' + orange('  ██'),
-    orange('  ██████████████'),
-    orange('   ██      ██'),
     '',
   ];
-  const banner = [
-    '╭' + '─'.repeat(W) + '╮',
-    ...inner.map((s) => '│' + s.padEnd(W).slice(0, W) + '│'),
-    '╰' + '─'.repeat(W) + '╯',
-  ];
-  return banner.map((l, i) => '  ' + accent(l) + (mascot[i] ? '  ' + mascot[i] : ''));
+  return left.map((l, i) => '  ' + l + (right[i] || ''));
 }
 
 function _printChatBanner(activeProvName, activeModel, version) {
@@ -1835,7 +1849,17 @@ async function _pickProviderInteractive() {
     provider = picked;
   }
 
-  // ── Step 3 — model ────────────────────────────────────────────
+  // ── Step 3 — model (or, for composite providers, a config wizard) ───
+  // The orchestrator (and any future composite provider) has no model
+  // of its own — it dispatches to other providers. Step 3 routes
+  // through a custom wizard instead of the standard model picker.
+  const providerMeta = (_registryMod.PROVIDER_INFO || {})[provider.id] || {};
+  if (providerMeta.composite || provider.id === 'orchestrator') {
+    const result = await _setupOrchestratorInteractive();
+    if (result === 'CANCEL') return null;
+    if (result === 'BACK')   return _pickProviderInteractive();
+    return { provider: provider.id, model: 'orchestrator' };
+  }
   const picked = await _pickModelInteractive(provider.id, {
     titlePrefix: 'LazyClaw setup — Step 3 of 3:',
     onBack: 'restart',
@@ -1845,6 +1869,125 @@ async function _pickProviderInteractive() {
   return { provider: provider.id, model: picked };
 }
 
+// Step-3 alternative for composite providers (currently only the
+// orchestrator). Builds `cfg.orchestrator = { planner, workers,
+// maxSubtasks }` interactively and persists it before returning.
+//
+// planner: single picker over registered non-composite providers.
+// workers: multi-select with a running list + add/remove/done loop.
+// maxSubtasks: typed integer, default 5.
+async function _setupOrchestratorInteractive() {
+  const accent = (s) => `\x1b[38;5;208m${s}\x1b[0m`;
+  const dim    = (s) => `\x1b[2m${s}\x1b[0m`;
+  const bold   = (s) => `\x1b[1m${s}\x1b[0m`;
+  const ok     = (s) => `\x1b[32m${s}\x1b[0m`;
+  const info = _registryMod.PROVIDER_INFO || {};
+  const eligibleNames = Object.keys(_registryMod.PROVIDERS).filter((n) => n !== 'orchestrator' && n !== 'mock');
+  if (eligibleNames.length === 0) {
+    process.stdout.write('\n' + accent('orchestrator setup') + ': no eligible workers — register a real provider first.\n');
+    await _quickPrompt('  press Enter to continue ');
+    return 'CANCEL';
+  }
+  const cfg = readConfig();
+  const existing = cfg.orchestrator && typeof cfg.orchestrator === 'object' ? cfg.orchestrator : {};
+
+  // ── Pick planner ─────────────────────────────────────────────────
+  const plannerItems = eligibleNames.map((name) => {
+    const m = info[name] || {};
+    const defaultModel = m.defaultModel || '';
+    return {
+      id: `${name}${defaultModel ? ':' + defaultModel : ''}`,
+      label: m.label && m.label !== name ? `${name} — ${m.label}` : name,
+      desc: defaultModel ? `default model: ${defaultModel}` : '',
+    };
+  });
+  const plannerPick = await _arrowMenu({
+    title: 'LazyClaw setup — Step 3 of 3:  orchestrator — pick the planner',
+    subtitle: 'The planner decomposes the user request into subtasks and writes the final synthesis. Strong reasoning models work best here.',
+    items: plannerItems,
+    searchable: true,
+    defaultIdx: Math.max(0, plannerItems.findIndex((p) => p.id === existing.planner)),
+  });
+  if (plannerPick === 'CANCEL') return 'CANCEL';
+  if (plannerPick === 'BACK')   return 'BACK';
+  const planner = plannerPick.id;
+
+  // ── Pick workers (iterative add/remove) ──────────────────────────
+  const workers = Array.isArray(existing.workers) ? existing.workers.slice() : [];
+  while (true) {
+    process.stdout.write('\x1b[2J\x1b[H');
+    process.stdout.write(accent('Orchestrator workers') + '\n');
+    process.stdout.write(dim('Subtasks are dispatched round-robin across this list.') + '\n\n');
+    if (workers.length === 0) {
+      process.stdout.write('  ' + dim('(none yet — add at least one)') + '\n\n');
+    } else {
+      workers.forEach((w, i) => {
+        process.stdout.write(`  ${i + 1}. ${ok(w)}\n`);
+      });
+      process.stdout.write('\n');
+    }
+    const items = [
+      { id: '__add__',    label: '+ Add a worker',     desc: 'pick from registered providers' },
+      { id: '__remove__', label: '- Remove a worker',  desc: workers.length ? 'pick which entry to drop' : '(nothing to remove)' },
+      { id: '__done__',   label: `Done${workers.length ? ` (${workers.length} worker${workers.length === 1 ? '' : 's'})` : ' — at least one worker required'}`, desc: workers.length ? 'save cfg.orchestrator and finish' : 'add one worker first' },
+    ];
+    const action = await _arrowMenu({
+      title: 'LazyClaw setup — orchestrator workers',
+      subtitle: `Planner: ${planner}`,
+      items,
+    });
+    if (action === 'CANCEL') return 'CANCEL';
+    if (action === 'BACK')   return 'BACK';
+    if (action.id === '__add__') {
+      const wPick = await _arrowMenu({
+        title: 'Add worker',
+        subtitle: 'Picked entries are appended to the workers list.',
+        items: plannerItems.filter((p) => !workers.includes(p.id)),
+        searchable: true,
+      });
+      if (wPick === 'CANCEL' || wPick === 'BACK') continue;
+      workers.push(wPick.id);
+      continue;
+    }
+    if (action.id === '__remove__') {
+      if (!workers.length) continue;
+      const rPick = await _arrowMenu({
+        title: 'Remove worker',
+        subtitle: 'Highlighted entry is removed from the list.',
+        items: workers.map((w) => ({ id: w, label: w })),
+      });
+      if (rPick === 'CANCEL' || rPick === 'BACK') continue;
+      const idx = workers.indexOf(rPick.id);
+      if (idx >= 0) workers.splice(idx, 1);
+      continue;
+    }
+    if (action.id === '__done__') {
+      if (workers.length === 0) continue;
+      break;
+    }
+  }
+
+  // ── maxSubtasks ──────────────────────────────────────────────────
+  const defaultMax = Number.isFinite(existing.maxSubtasks) && existing.maxSubtasks > 0
+    ? Math.min(10, existing.maxSubtasks)
+    : 5;
+  const rawMax = (await _quickPrompt(`  ${bold('maxSubtasks')} ${dim(`(2..10, blank → ${defaultMax}):`)} `)).trim();
+  let maxSubtasks = defaultMax;
+  if (rawMax) {
+    const n = parseInt(rawMax, 10);
+    if (Number.isFinite(n) && n >= 1) maxSubtasks = Math.min(10, Math.max(1, n));
+  }
+
+  // ── Persist ──────────────────────────────────────────────────────
+  cfg.orchestrator = { planner, workers, maxSubtasks };
+  writeConfig(cfg);
+  process.stdout.write('\n');
+  process.stdout.write(`  ${ok('✓ orchestrator saved')}  ${dim('→')} ` +
+    `planner ${ok(planner)}  ·  ${workers.length} worker${workers.length === 1 ? '' : 's'}  ·  maxSubtasks ${maxSubtasks}\n`);
+  await _quickPrompt('  press Enter to continue ');
+  return { ok: true };
+}
+
 // Pause the chat REPL's readline + ghost-autocomplete while a sub-picker
 // (provider / model arrow menu) takes over the terminal. The sub-picker
 // installs its own `keypress` listener and toggles raw mode; the chat's
@@ -3722,6 +3865,126 @@ async function cmdProviders(sub, positional, flags = {}) {
   }
 }
 
+// `lazyclaw orchestrator` — read/write the cfg.orchestrator section
+// without editing config.json by hand. Mirrors the shape `lazyclaw
+// providers` / `lazyclaw rates` already use.
+//
+// Subcommands:
+//   status                        Print current planner / workers / maxSubtasks as JSON.
+//   set-planner <provider[:model]>  Replace the planner spec.
+//   workers add <provider[:model]>  Append a worker (idempotent — duplicates skipped).
+//   workers remove <provider[:model]>  Drop a worker by exact match. Idempotent.
+//   workers clear                 Empty the workers list.
+//   workers set <provider[:model],...>  Replace the whole list (comma-separated).
+//   set-max-subtasks <N>          Cap the number of subtasks (clamped 1..10).
+//   clear                         Delete the entire cfg.orchestrator block.
+async function cmdOrchestrator(sub, positional, _flags = {}) {
+  await ensureRegistry();
+  const cfg = readConfig();
+  const orch = cfg.orchestrator && typeof cfg.orchestrator === 'object' ? cfg.orchestrator : {};
+  const known = Object.keys(_registryMod.PROVIDERS);
+  const validateSpec = (spec) => {
+    if (!spec) throw new Error('provider spec required (e.g. "claude-cli" or "openai:gpt-4o")');
+    const colon = spec.indexOf(':');
+    const provName = colon > 0 ? spec.slice(0, colon) : spec;
+    if (provName === 'orchestrator') throw new Error('"orchestrator" cannot reference itself — pick a real provider');
+    if (!known.includes(provName)) {
+      throw new Error(`unknown provider "${provName}" — registered: ${known.join(', ')}`);
+    }
+    return spec;
+  };
+  const saveAndPrint = (next) => {
+    if (next === null) delete cfg.orchestrator;
+    else cfg.orchestrator = next;
+    writeConfig(cfg);
+    console.log(JSON.stringify(cfg.orchestrator || null, null, 2));
+  };
+  switch (sub) {
+    case undefined:
+    case 'status': {
+      console.log(JSON.stringify({
+        ok: true,
+        configured: !!cfg.orchestrator,
+        planner: orch.planner || null,
+        workers: Array.isArray(orch.workers) ? orch.workers : [],
+        maxSubtasks: Number.isFinite(orch.maxSubtasks) ? orch.maxSubtasks : null,
+        knownProviders: known,
+      }, null, 2));
+      return;
+    }
+    case 'set-planner': {
+      try {
+        const spec = validateSpec(positional[0]);
+        saveAndPrint({ ...orch, planner: spec });
+      } catch (e) { console.error(`orchestrator: ${e.message}`); process.exit(2); }
+      return;
+    }
+    case 'workers': {
+      const wsub = positional[0];
+      const workers = Array.isArray(orch.workers) ? orch.workers.slice() : [];
+      switch (wsub) {
+        case 'add': {
+          try {
+            const spec = validateSpec(positional[1]);
+            if (!workers.includes(spec)) workers.push(spec);
+            saveAndPrint({ ...orch, workers });
+          } catch (e) { console.error(`orchestrator: ${e.message}`); process.exit(2); }
+          return;
+        }
+        case 'remove': {
+          const spec = positional[1];
+          if (!spec) { console.error('orchestrator: workers remove <provider[:model]>'); process.exit(2); }
+          const idx = workers.indexOf(spec);
+          if (idx >= 0) workers.splice(idx, 1);
+          saveAndPrint({ ...orch, workers });
+          return;
+        }
+        case 'clear': {
+          saveAndPrint({ ...orch, workers: [] });
+          return;
+        }
+        case 'set': {
+          const raw = positional[1] || '';
+          const specs = raw.split(',').map((s) => s.trim()).filter(Boolean);
+          try {
+            specs.forEach(validateSpec);
+            saveAndPrint({ ...orch, workers: specs });
+          } catch (e) { console.error(`orchestrator: ${e.message}`); process.exit(2); }
+          return;
+        }
+        default: {
+          console.error('Usage: lazyclaw orchestrator workers <add <spec> | remove <spec> | clear | set <spec,spec,...>>');
+          process.exit(2);
+        }
+      }
+    }
+    case 'set-max-subtasks': {
+      const n = parseInt(positional[0], 10);
+      if (!Number.isFinite(n) || n < 1) { console.error('orchestrator: set-max-subtasks <N>  (1..10)'); process.exit(2); }
+      saveAndPrint({ ...orch, maxSubtasks: Math.min(10, Math.max(1, n)) });
+      return;
+    }
+    case 'clear': {
+      saveAndPrint(null);
+      return;
+    }
+    default: {
+      console.error(
+        'Usage:\n' +
+        '  lazyclaw orchestrator status\n' +
+        '  lazyclaw orchestrator set-planner <provider[:model]>\n' +
+        '  lazyclaw orchestrator workers add <provider[:model]>\n' +
+        '  lazyclaw orchestrator workers remove <provider[:model]>\n' +
+        '  lazyclaw orchestrator workers set <provider[:model],...>\n' +
+        '  lazyclaw orchestrator workers clear\n' +
+        '  lazyclaw orchestrator set-max-subtasks <N>\n' +
+        '  lazyclaw orchestrator clear'
+      );
+      process.exit(2);
+    }
+  }
+}
+
 async function cmdSessions(sub, positional, flags = {}) {
   const sessionsMod = await import('./sessions.mjs');
   const cfgDir = path.dirname(configPath());
@@ -4614,6 +4877,11 @@ async function main() {
       await cmdProviders(sub, rest.positional.slice(1), rest.flags);
       break;
     }
+    case 'orchestrator': {
+      const sub = rest.positional[0];
+      await cmdOrchestrator(sub, rest.positional.slice(1), rest.flags);
+      break;
+    }
     case 'skills': {
       const sub = rest.positional[0];
       await cmdSkills(sub, rest.positional.slice(1), rest.flags);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lazyclaw",
-  "version": "3.99.21",
+  "version": "3.99.23",
   "description": "Lazy, elegant terminal CLI for chatting with Claude / OpenAI / Gemini / Ollama and orchestrating multi-step LLM workflows. Banner-on-launch, slash-command ghost autocomplete, persistent sessions, local HTTP gateway.",
   "keywords": [
     "claude",

package/providers/orchestrator.mjs

@@ -124,6 +124,14 @@ export function makeOrchestratorProvider(opts = {}) {
       const fallbackSpec = cfg.provider && cfg.provider !== 'orchestrator'
         ? `${cfg.provider}${cfg.model ? ':' + cfg.model : ''}`
         : 'claude-cli';
+      // First-run hint when cfg.orchestrator is missing entirely. The
+      // fallback path below still works (planner = cfg.provider, single
+      // worker = same), but the user almost certainly meant to opt in
+      // explicitly — surface the shortest valid CLI to set it up.
+      if (!cfg.orchestrator) {
+        yield `> orchestrator: \`cfg.orchestrator\` is not set. Defaulting to a single-agent chain on \`${fallbackSpec}\`.\n` +
+          `> Configure properly:  \`lazyclaw orchestrator set-planner ${fallbackSpec}\` then  \`lazyclaw orchestrator workers add <provider:model>\` (one per agent).\n\n`;
+      }
       const plannerSpec = String(o.planner || fallbackSpec);
       const workerSpecs = Array.isArray(o.workers) && o.workers.length
         ? o.workers.map(String)

package/web/dashboard.html

@@ -42,24 +42,14 @@
       gap: 14px;
     }
     .logo { font-weight: 700; font-size: 16px; color: var(--accent); display: flex; align-items: center; gap: 10px; }
-    .logo .mascot { width: 36px; height: 32px; flex: none; }
+    .logo .mascot { width: 44px; height: 44px; flex: none; image-rendering: pixelated; image-rendering: crisp-edges; }
     .ver  { color: var(--dim); font-size: 11px; }
-    /* lazyclaude pixel-mascot — copied verbatim from dist/index.html so the
-       lazyclaw web dashboard wears the same character as the larger SPA. */
-    .mascot .mj-body   { animation: mj-jump 1s ease-in-out infinite; transform-origin: center bottom; }
-    .mascot .mj-shadow { animation: mj-sh   1s ease-in-out infinite; }
-    .mascot .mj-la     { animation: mj-wl   1s ease-in-out infinite; transform-origin: right center; }
-    .mascot .mj-ra     { animation: mj-wr   1s ease-in-out infinite; transform-origin: left center; }
-    .mascot .mj-le     { animation: mj-ear  1s ease-in-out infinite; transform-origin: center bottom; }
-    .mascot .mj-re     { animation: mj-ear  1s ease-in-out infinite .1s; transform-origin: center bottom; }
-    @keyframes mj-jump { 0%, 100% { transform: translateY(0) scaleY(1) scaleX(1); } 30% { transform: translateY(-10px) scaleY(1.1) scaleX(.95); } 50% { transform: translateY(-12px) scaleY(1.05) scaleX(.98); } 80% { transform: translateY(-3px) scaleY(.95) scaleX(1.05); } }
-    @keyframes mj-sh   { 0%, 100% { transform: scaleX(1); opacity: .25; } 50% { transform: scaleX(.4); opacity: .08; } }
-    @keyframes mj-wl   { 0%, 100% { transform: rotate(0); } 50% { transform: rotate(-25deg); } }
-    @keyframes mj-wr   { 0%, 100% { transform: rotate(0); } 50% { transform: rotate(25deg); } }
-    @keyframes mj-ear  { 0%, 100% { transform: scaleY(1); } 40% { transform: scaleY(1.2); } 60% { transform: scaleY(.85); } }
-    @media (prefers-reduced-motion: reduce) {
-      .mascot .mj-body, .mascot .mj-shadow, .mascot .mj-la, .mascot .mj-ra, .mascot .mj-le, .mascot .mj-re { animation: none; }
-    }
+    /* lazyclaw 16x16 pixel mascot — Claude Design handoff (mascot sheet
+       v0.1, "claude original" palette). Claude's asterisk star (#d97757)
+       worn under a crustacean helmet (#c33d2a) with two antenna-claws.
+       Idle pose (sleepy slits). Hover gently brightens the helmet. */
+    .mascot { transition: filter 0.2s ease; }
+    .logo:hover .mascot { filter: drop-shadow(0 0 6px rgba(217, 119, 87, 0.45)); }
     nav.tabs {
       display: flex;
       gap: 2px;
@@ -286,22 +276,39 @@
 <body>
   <header>
     <div class="logo">
-      <svg class="mascot" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 90" aria-hidden="true">
-        <ellipse class="mj-shadow" cx="50" cy="82" rx="22" ry="5" fill="#000"/>
-        <g class="mj-body">
-          <rect class="mj-le" x="22" y="10" width="8" height="14" fill="#d97757"/>
-          <rect class="mj-re" x="70" y="10" width="8" height="14" fill="#d97757"/>
-          <rect x="18" y="24" width="64" height="4" fill="#d97757"/>
-          <rect x="14" y="28" width="72" height="32" fill="#d97757"/>
-          <rect x="30" y="34" width="8" height="10" fill="#000"/>
-          <rect x="62" y="34" width="8" height="10" fill="#000"/>
-          <rect class="mj-la" x="2"  y="36" width="12" height="8" fill="#d97757"/>
-          <rect class="mj-ra" x="86" y="36" width="12" height="8" fill="#d97757"/>
-          <rect x="24" y="60" width="12" height="14" fill="#d97757"/>
-          <rect x="64" y="60" width="12" height="14" fill="#d97757"/>
-        </g>
+      <svg class="mascot" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" shape-rendering="crispEdges" aria-label="lazyclaw mascot" role="img">
+        <!-- antennae / claws -->
+        <rect x="3"  y="1"  width="1"  height="1" fill="#a02b1c"/>
+        <rect x="12" y="1"  width="1"  height="1" fill="#a02b1c"/>
+        <rect x="3"  y="2"  width="1"  height="1" fill="#a02b1c"/>
+        <rect x="12" y="2"  width="1"  height="1" fill="#a02b1c"/>
+        <!-- helmet -->
+        <rect x="3"  y="3"  width="10" height="1" fill="#c33d2a"/>
+        <rect x="2"  y="4"  width="12" height="1" fill="#c33d2a"/>
+        <rect x="1"  y="5"  width="2"  height="1" fill="#c33d2a"/>
+        <rect x="3"  y="5"  width="1"  height="1" fill="#ff8a6a"/>
+        <rect x="4"  y="5"  width="8"  height="1" fill="#c33d2a"/>
+        <rect x="12" y="5"  width="1"  height="1" fill="#ff8a6a"/>
+        <rect x="13" y="5"  width="2"  height="1" fill="#c33d2a"/>
+        <rect x="1"  y="6"  width="14" height="1" fill="#c33d2a"/>
+        <rect x="2"  y="7"  width="12" height="1" fill="#c33d2a"/>
+        <!-- star body (Claude asterisk) — top edge below helmet brim -->
+        <rect x="3"  y="8"  width="10" height="1" fill="#d97757"/>
+        <!-- face row (idle: sleepy slit eyes) -->
+        <rect x="2"  y="9"  width="3"  height="1" fill="#d97757"/>
+        <rect x="5"  y="9"  width="2"  height="1" fill="#1a1410"/>
+        <rect x="7"  y="9"  width="2"  height="1" fill="#d97757"/>
+        <rect x="9"  y="9"  width="2"  height="1" fill="#1a1410"/>
+        <rect x="11" y="9"  width="3"  height="1" fill="#d97757"/>
+        <!-- star arms + tip -->
+        <rect x="1"  y="10" width="14" height="1" fill="#d97757"/>
+        <rect x="0"  y="11" width="16" height="1" fill="#d97757"/>
+        <rect x="1"  y="12" width="14" height="1" fill="#d97757"/>
+        <rect x="3"  y="13" width="10" height="1" fill="#d97757"/>
+        <rect x="5"  y="14" width="6"  height="1" fill="#d97757"/>
+        <rect x="7"  y="15" width="2"  height="1" fill="#d97757"/>
       </svg>
-      <span>LazyClaw</span>
+      <span>lazyclaw</span>
     </div>
     <div class="ver" id="version">…</div>
   </header>