@7ots/cli 0.1.0

package/cli/lib/ui.mjs

@@ -0,0 +1,234 @@
+/**
+ * Small terminal UI for the wizard: step headers, arrow-key menus that collapse into a ✔ line once
+ * answered, text/secret inputs, cards and summaries. Plain numbered menus when there is no TTY raw mode.
+ */
+
+import { emitKeypressEvents } from 'node:readline';
+import { createInterface } from 'node:readline/promises';
+import { Writable } from 'node:stream';
+
+const tty = Boolean(process.stdout.isTTY);
+const truecolor = tty && /truecolor|24bit/i.test(process.env.COLORTERM || '');
+const esc = (code) => (s) => (tty ? `\x1b[${code}m${s}\x1b[0m` : String(s));
+export const bold = esc(1);
+export const dim = esc(2);
+export const green = esc(32);
+export const red = esc(31);
+export const yellow = esc(33);
+export const cyan = esc(36);
+export const gray = esc(90);
+
+let ACCENT = '#6d5dfc';
+export const setAccent = (hex) => /^#[0-9a-f]{6}$/i.test(hex || '') && (ACCENT = hex);
+/** Text in the ot's color (24-bit when the terminal says so, else magenta). */
+export const accent = (s) => {
+  if (!tty) return String(s);
+  if (!truecolor) return `\x1b[35m${s}\x1b[0m`;
+  const n = parseInt(ACCENT.slice(1), 16);
+  return `\x1b[38;2;${(n >> 16) & 255};${(n >> 8) & 255};${n & 255}m${s}\x1b[0m`;
+};
+
+const ANSI = /\x1b\[[0-9;]*m/g;
+export const width = (s) => [...String(s).replace(ANSI, '')].length;
+const pad = (s, n) => s + ' '.repeat(Math.max(0, n - width(s)));
+const cols = () => Math.max(40, Math.min(process.stdout.columns || 80, 92));
+const write = (s) => process.stdout.write(s);
+const up = (n) => n > 0 && tty && write(`\x1b[${n}A\r\x1b[J`);
+/** How many terminal rows a printed text takes (for collapsing it later). */
+const rows = (text) => String(text).split('\n').reduce((n, l) => n + Math.max(1, Math.ceil(width(l) / (process.stdout.columns || 80))), 0);
+
+const BAR = gray('│');
+const S_DONE = green('✔');
+const S_STEP = accent('◆');
+
+// ── readline (text input), muted for secrets ──
+let muted = false;
+const out = new Writable({
+  write(chunk, enc, cb) {
+    if (!muted) process.stdout.write(chunk, enc);
+    cb();
+  },
+});
+let rl = null;
+const io = () => (rl ||= createInterface({ input: process.stdin, output: out, terminal: tty }));
+export function closeUi() {
+  rl?.close();
+  rl = null;
+}
+
+// ── layout ──
+
+export function intro(title, subtitle = '') {
+  const line = '─'.repeat(Math.max(4, cols() - width(title) - 8));
+  console.log(`\n ${accent('▍')}${bold(title)} ${gray(line)}`);
+  if (subtitle) console.log(` ${BAR} ${dim(subtitle)}`);
+}
+
+/** "◆ Brain ·········· 4/8" + dots. */
+export function step(n, total, title) {
+  const dots = Array.from({ length: total }, (_, i) => (i < n - 1 ? accent('●') : i === n - 1 ? accent('◉') : gray('○'))).join(' ');
+  console.log(`\n ${S_STEP} ${bold(title)}  ${dots}  ${gray(`${n}/${total}`)}`);
+}
+
+export const note = (text) => console.log(String(text).split('\n').map((l) => ` ${BAR} ${dim(l)}`).join('\n'));
+export const ok = (text) => console.log(` ${BAR} ${green('✓')} ${text}`);
+export const warn = (text) => console.log(` ${BAR} ${yellow('!')} ${text}`);
+
+/** Rounded box. lines: strings (may carry ANSI). */
+export function card(lines, { title = '', color = gray } = {}) {
+  const max = cols() - 6;
+  lines = lines.map((l) => (width(l) > max - 2 ? clip(l, max - 2) : l));
+  const inner = Math.min(max, Math.max(...lines.map(width), width(title) + 2) + 2);
+  const rule = (n) => '─'.repeat(Math.max(0, n));
+  console.log(title ? ` ${color('╭─')} ${bold(title)} ${color(`${rule(inner - width(title) - 3)}╮`)}` : ` ${color(`╭${rule(inner)}╮`)}`);
+  for (const l of lines) console.log(` ${color('│')} ${pad(l, inner - 2)} ${color('│')}`);
+  console.log(` ${color(`╰${'─'.repeat(inner)}╯`)}`);
+  return lines.length + 2;
+}
+
+/** Keeps the start and the end of a too-long (plain) line: "~/a/very/…/file.json". */
+function clip(l, n) {
+  const plain = [...l.replace(ANSI, '')];
+  const head = Math.ceil((n - 1) / 2);
+  return `${plain.slice(0, head).join('')}…${plain.slice(plain.length - (n - 1 - head)).join('')}`;
+}
+
+/** Erases the last n printed rows. */
+export const erase = (n) => up(n);
+
+/** Two-column summary inside a card. */
+export function summary(title, pairs) {
+  const k = Math.max(...pairs.map(([a]) => width(a)));
+  return card(pairs.map(([a, b]) => `${gray(pad(a, k))}  ${b}`), { title });
+}
+
+// ── inputs ──
+
+function collapse(lines, question, answer) {
+  up(lines);
+  console.log(` ${S_DONE} ${question} ${gray('·')} ${accent(answer)}`);
+}
+
+/** Text input. Returns the answer or the default. */
+export async function text(question, { def = '', hint = '', validate } = {}) {
+  for (;;) {
+    const head = ` ${S_STEP} ${bold(question)}${hint ? `  ${gray(hint)}` : ''}`;
+    console.log(head);
+    const a = (await io().question(` ${BAR} ${def !== '' ? gray(`(${def}) `) : ''}`)).trim() || String(def);
+    const err = validate?.(a);
+    if (!err) {
+      collapse(rows(head) + 1, question, a === '' ? gray('—') : a);
+      return a;
+    }
+    up(rows(head) + 1);
+    console.log(` ${BAR} ${red(err)}`);
+  }
+}
+
+/** Hidden input (keys): nothing is echoed. */
+export async function secret(question) {
+  console.log(` ${S_STEP} ${bold(question)}`);
+  write(` ${BAR} ${gray('••••')} `);
+  muted = true;
+  let v;
+  try {
+    v = (await io().question('')).trim();
+  } finally {
+    muted = false;
+    write('\n');
+  }
+  collapse(2, question, v ? '••••••••' : gray('—'));
+  return v;
+}
+
+/**
+ * Menu. options: [{ value, label, hint? }] or [[value, label, hint?]]. Returns the value.
+ * ↑/↓ (or j/k) move, 1-9 jump, Enter picks, Ctrl-C quits.
+ */
+export async function select(question, options, def) {
+  const opts = options.map((o) => (Array.isArray(o) ? { value: o[0], label: o[1], hint: o[2] } : o));
+  let i = Math.max(0, opts.findIndex((o) => o.value === def));
+  if (!tty || !process.stdin.isTTY || typeof process.stdin.setRawMode !== 'function') return numbered(question, opts, i);
+
+  closeUi(); // readline and raw keypresses must not share stdin
+  emitKeypressEvents(process.stdin);
+  process.stdin.setRawMode(true);
+  process.stdin.resume();
+  write('\x1b[?25l');
+  let printed = 0;
+  const draw = () => {
+    up(printed);
+    const lines = [` ${S_STEP} ${bold(question)}`];
+    opts.forEach((o, k) => {
+      const on = k === i;
+      lines.push(` ${BAR} ${on ? accent('❯') : ' '} ${on ? bold(o.label) : o.label}${o.hint ? `  ${gray(o.hint)}` : ''}`);
+    });
+    lines.push(` ${BAR} ${gray('↑/↓ · enter')}`);
+    const s = lines.join('\n');
+    console.log(s);
+    printed = rows(s);
+  };
+  draw();
+  try {
+    return await new Promise((resolve) => {
+      const onKey = (str, key = {}) => {
+        if (key.ctrl && key.name === 'c') {
+          write('\x1b[?25h\n');
+          process.exit(130);
+        }
+        if (key.name === 'up' || str === 'k') i = (i - 1 + opts.length) % opts.length;
+        else if (key.name === 'down' || str === 'j' || key.name === 'tab') i = (i + 1) % opts.length;
+        else if (/^[1-9]$/.test(str || '') && Number(str) <= opts.length) i = Number(str) - 1;
+        else if (key.name === 'return' || key.name === 'enter') {
+          process.stdin.off('keypress', onKey);
+          return resolve(opts[i].value);
+        } else return;
+        draw();
+      };
+      process.stdin.on('keypress', onKey);
+    });
+  } finally {
+    process.stdin.setRawMode(false);
+    process.stdin.pause();
+    write('\x1b[?25h');
+    collapse(printed, question, opts[i].label);
+  }
+}
+
+async function numbered(question, opts, i) {
+  console.log(` ${S_STEP} ${bold(question)}`);
+  opts.forEach((o, k) => console.log(` ${BAR} ${cyan(k + 1)}) ${o.label}${o.hint ? `  ${gray(o.hint)}` : ''}`));
+  for (;;) {
+    const a = (await io().question(` ${BAR} ${gray(`(${i + 1}) `)}`)).trim();
+    if (!a) return opts[i].value;
+    const n = Number(a);
+    if (n >= 1 && n <= opts.length) return opts[n - 1].value;
+    const byValue = opts.find((o) => o.value === a);
+    if (byValue) return byValue.value;
+  }
+}
+
+export async function confirm(question, def = true, [yes, no] = ['yes', 'no']) {
+  return (await select(question, [[true, yes], [false, no]], def)) === true;
+}
+
+/** Spinner for slow steps (Orquesta login, etc.). Returns stop(finalText). */
+export function spinner(textLine) {
+  if (!tty) {
+    console.log(` ${BAR} ${textLine}`);
+    return (done) => done && console.log(` ${BAR} ${done}`);
+  }
+  const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+  let f = 0;
+  write('\x1b[?25l');
+  const id = setInterval(() => write(`\r ${accent(frames[f++ % frames.length])} ${textLine}\x1b[K`), 80);
+  return (done) => {
+    clearInterval(id);
+    write(`\r\x1b[K\x1b[?25h`);
+    if (done) console.log(` ${S_DONE} ${done}`);
+  };
+}
+
+export function outro(text) {
+  console.log(` ${gray('└')} ${text}\n`);
+}

package/cli/lib/wizard.mjs

@@ -0,0 +1,279 @@
+/**
+ * `7ots setup`: a short interactive wizard.
+ *
+ *   language → identity (keep / new, re-roll) → where the ot lives (local · 7ots.com · own server · Orquesta project)
+ *   → brain (an AI CLI · API key · its 7ots home · Orquesta Batuta · built-in phrases) → voice → pet mode + chattiness
+ *   → hooks (Claude Code, shell) → summary → wake it up?
+ *
+ * Keys are read hidden and saved in ~/.7ots/keys.json (0600); the ones already in the environment are used as-is.
+ */
+
+import { createIdentity, loadIdentity, identityPath } from './identity.mjs';
+import { CONFIG_DEFAULTS, loadConfig, saveConfig, saveKey, hasKey, ORQUESTA_URL } from './config.mjs';
+import { detectClis } from './brain.mjs';
+import { installClaudeHooks, installShellHooks } from './hooks.mjs';
+import { platformLink } from './install.mjs';
+import { FACES } from './terminal.mjs';
+import { t, setCliLang, cliLang } from './i18n.mjs';
+import { existsSync, homeFile, PET_PORT } from './paths.mjs';
+import * as ui from './ui.mjs';
+
+const STEPS = 7;
+const short = (label) => String(label).split(/ [—(-] ?/)[0];
+const pretty = (f) => String(f).replace(process.env.HOME || '\0', '~');
+
+/** Menu, used by `7ots pet` too. options: [[value, label, hint?], …]. */
+export async function choose(q, options, def = options[0][0]) {
+  try {
+    return await ui.select(q, options, def);
+  } finally {
+    ui.closeUi();
+  }
+}
+
+async function key(name) {
+  if (hasKey(name)) {
+    ui.ok(t('w.keyEnv', { name }));
+    return true;
+  }
+  const v = await ui.secret(t('w.key', { name }));
+  if (!v) return false;
+  saveKey(name, v);
+  ui.ok(t('w.keySaved'));
+  return true;
+}
+
+/** The ot as a little card: face in its color, name, role, tagline, personality. */
+function idCard(identity) {
+  ui.setAccent(identity.look?.character?.body?.color);
+  const [l, m, r] = FACES.happy;
+  const p = identity.personality || {};
+  const face = ui.accent(`(${l}${m}${r})`);
+  return ui.card(
+    [
+      `${face}  ${ui.bold(identity.name)} ${ui.gray('—')} ${identity.role}`,
+      `       ${ui.dim(`“${identity.tagline}”`)}`,
+      `       ${p.tone}${p.traits?.length ? ui.gray(` · ${p.traits.join(', ')}`) : ''}`,
+      `       ${ui.gray(`seed ${identity.seed || '—'} · voice ${identity.voice?.lang} · meet ${identity.look?.meetAvatar || '—'}`)}`,
+    ],
+    { title: t('w.idCard') },
+  );
+}
+
+/** Wizard entry point. Returns { launch, mode } when the user wants to wake the pet now. */
+export async function runWizard() {
+  if (!process.stdin.isTTY) {
+    console.error('7ots setup is interactive: run it in a terminal (in Claude Code: ! npx @7ots/cli setup).');
+    process.exit(1);
+  }
+  try {
+    return await steps();
+  } finally {
+    ui.closeUi();
+  }
+}
+
+async function steps() {
+  const cfg = loadConfig();
+  const yesNo = [t('yes'), t('no')];
+
+  ui.intro('7ots setup', t('w.intro'));
+
+  // 1 · language + identity (the global one is the pet's; a project identity still wins inside its project)
+  ui.step(1, STEPS, t('w.s.identity'));
+  const lang = await ui.select(t('w.lang'), [['en', 'English'], ['es', 'Español'], ['pt', 'Português']], cfg.lang || cliLang());
+  setCliLang(lang);
+  cfg.lang = lang;
+
+  let { identity } = loadIdentity();
+  if (identity) {
+    idCard(identity);
+    const keep = await ui.select(t('w.identity'), [['keep', t('w.idKeep', { name: identity.name })], ['new', t('w.idNew')]], 'keep');
+    if (keep === 'new') identity = null;
+  }
+  if (!identity) {
+    let name;
+    for (;;) {
+      identity = createIdentity({ global: true, force: true, lang, name }).identity;
+      const shown = idCard(identity);
+      const a = await ui.select(t('w.idLike'), [['keep', t('w.idThis')], ['again', t('w.idAgain')], ['name', t('w.idName')]], 'keep');
+      if (a === 'keep') break;
+      name = a === 'name' ? (await ui.text(t('w.idNameQ'), { validate: (v) => (v ? '' : t('w.required')) })).slice(0, 40) : undefined;
+      ui.erase(shown + 1 + (a === 'name' ? 1 : 0)); // the old card + its answer: the new one takes its place
+    }
+  }
+
+  // 2 · home
+  ui.step(2, STEPS, t('w.s.home'));
+  const home = await ui.select(t('w.home'), [
+    ['local', t('w.home.local'), t('w.h.local')],
+    ['7ots', t('w.home.7ots'), t('w.h.7ots')],
+    ['server', t('w.home.server'), t('w.h.server')],
+    ['orquesta', t('w.home.orquesta'), t('w.h.orquesta')],
+  ], cfg.home.kind);
+  const url = (v) => (/^https?:\/\/\S+$/.test(v) ? '' : t('w.badUrl'));
+  if (home === '7ots') {
+    ui.note(t('w.home7otsUrl', { app: platformLink(identity.seed) }));
+    const u = await ui.text('URL', { def: cfg.home.kind === '7ots' ? cfg.home.url : '', validate: url });
+    cfg.home = { kind: '7ots', url: u.replace(/\/+$/, '').replace(/\/(chat|embed\.js)$/, '') };
+  } else if (home === 'server') {
+    const u = await ui.text(t('w.homeServerUrl'), { def: cfg.home.kind === 'server' ? cfg.home.url : '', validate: url });
+    cfg.home = { kind: 'server', url: u.replace(/\/+$/, '') };
+  } else if (home === 'orquesta') {
+    cfg.home = await orquestaHome(cfg.home);
+  } else {
+    cfg.home = { kind: 'local' };
+  }
+  if (['7ots', 'server'].includes(cfg.home.kind)) ui.warn(t('w.originHint', { port: PET_PORT }));
+
+  // 3 · brain
+  ui.step(3, STEPS, t('w.s.brain'));
+  const clis = detectClis();
+  const brainOpts = [
+    ...clis.map((k) => [`cli:${k}`, t('w.brain.cli', { cli: k }), t('w.h.cli')]),
+    ['api', t('w.brain.api'), t('w.h.api')],
+    ...(['7ots', 'server'].includes(cfg.home.kind) ? [['7ots', t('w.brain.7ots', { url: cfg.home.url })]] : []),
+    ...(cfg.home.kind === 'orquesta' || hasKey('ORQUESTA_TOKEN') ? [['batuta', t('w.brain.batuta')]] : []),
+    ['lines', t('w.brain.lines'), t('w.h.lines')],
+  ];
+  const curBrain = cfg.brain.kind === 'cli' ? `cli:${cfg.brain.cli}` : cfg.brain.kind;
+  const configured = existsSync(homeFile('config.json')) && curBrain !== 'lines';
+  const brain = await ui.select(t('w.brain'), brainOpts, configured && brainOpts.some(([v]) => v === curBrain) ? curBrain : brainOpts[0][0]);
+  if (brain.startsWith('cli:')) {
+    const cli = brain.slice(4);
+    const model = await ui.text(t('w.model'), { def: cfg.brain.cli === cli ? cfg.brain.model || '' : cli === 'claude' ? 'haiku' : '' });
+    cfg.brain = { kind: 'cli', cli, ...(model ? { model } : {}) };
+  } else if (brain === 'api') {
+    const provider = await ui.select(t('w.provider'), [['anthropic', 'Anthropic'], ['openai', 'OpenAI / compatible']], cfg.brain.provider || 'anthropic');
+    const baseUrl = provider === 'openai' ? await ui.text(t('w.baseUrl'), { def: cfg.brain.baseUrl || '' }) : '';
+    const model = await ui.text(t('w.model'), { def: cfg.brain.model || (provider === 'anthropic' ? 'claude-haiku-4-5-20251001' : '') });
+    await key(provider === 'anthropic' ? 'ANTHROPIC_API_KEY' : 'OPENAI_API_KEY');
+    cfg.brain = { kind: 'api', provider, ...(model ? { model } : {}), ...(baseUrl ? { baseUrl } : {}) };
+  } else if (brain === 'batuta') {
+    if (!hasKey('ORQUESTA_TOKEN')) await orquestaLogin();
+    cfg.brain = { kind: 'batuta' };
+  } else {
+    cfg.brain = { kind: brain };
+  }
+
+  // 4 · voice
+  ui.step(4, STEPS, t('w.s.voice'));
+  const voice = await ui.select(t('w.voice'), [
+    ['browser', t('w.voice.browser')],
+    ['apuchat', t('w.voice.apuchat')],
+    ['elevenlabs', t('w.voice.elevenlabs')],
+    ['grok', t('w.voice.grok')],
+    ['fish', t('w.voice.fish')],
+    ['none', t('w.voice.none')],
+  ], cfg.voice.kind);
+  const VOICE_KEY = { apuchat: 'APUCHAT_VOICE_TOKEN', elevenlabs: 'ELEVENLABS_API_KEY', grok: 'XAI_API_KEY', fish: 'FISH_API_KEY' };
+  cfg.voice = { kind: voice };
+  if (VOICE_KEY[voice]) {
+    if (!(await key(VOICE_KEY[voice]))) {
+      cfg.voice = { kind: 'browser' };
+      ui.warn(t('w.voiceFallback'));
+    } else if (voice !== 'apuchat') {
+      const id = await ui.text(t('w.voiceId'));
+      if (id) cfg.voice.voiceId = id;
+    }
+  }
+
+  // 5 · pet
+  ui.step(5, STEPS, t('w.s.pet'));
+  const mode = await ui.select(t('w.mode'), [
+    ['ask', t('mode.ask')],
+    ['desktop', t('mode.desktop')],
+    ['terminal', t('mode.terminal')],
+    ['browser', t('mode.browser')],
+  ], cfg.pet.mode || CONFIG_DEFAULTS.pet.mode);
+  const annoy = await ui.select(t('w.annoyQ'), [0, 1, 2, 3].map((n) => [n, t(`w.annoy.${n}`)]), Number(cfg.pet.annoy ?? 2));
+  cfg.pet = { mode, annoy };
+
+  // 6 · hooks
+  ui.step(6, STEPS, t('w.s.hooks'));
+  const claude = await ui.select(t('w.hooksClaude'), [
+    ['project', t('w.hooksClaude.project'), pretty(process.cwd())],
+    ['global', t('w.hooksClaude.global'), '~/.claude/settings.json'],
+    ['no', t('w.hooksClaude.no')],
+  ], 'project');
+  const hooks = [];
+  if (claude !== 'no') {
+    const f = installClaudeHooks({ global: claude === 'global' });
+    ui.ok(t('hooks.claude', { file: pretty(f) }));
+    hooks.push('Claude Code');
+  }
+  if (await ui.confirm(t('w.hooksShell'), false, yesNo)) {
+    const files = installShellHooks();
+    if (files.length) ui.ok(t('hooks.shell', { files: files.map(pretty).join(', ') }));
+    else ui.warn(t('hooks.shellNone'));
+    ui.note(t('hooks.reload'));
+    hooks.push('shell');
+  }
+
+  // 7 · save + summary
+  ui.step(7, STEPS, t('w.s.done'));
+  saveConfig(cfg);
+  const homeLabel = { local: t('w.home.local'), '7ots': cfg.home.url, server: cfg.home.url, orquesta: `Orquesta · ${cfg.home.projectName || ''}` }[cfg.home.kind];
+  const brainLabel = cfg.brain.kind === 'cli' ? `${cfg.brain.cli}${cfg.brain.model ? ` · ${cfg.brain.model}` : ''}` : cfg.brain.kind === 'api' ? `${cfg.brain.provider}${cfg.brain.model ? ` · ${cfg.brain.model}` : ''}` : cfg.brain.kind === 'lines' ? t('w.brain.lines') : cfg.brain.kind;
+  ui.summary(t('w.sum.title'), [
+    [t('w.sum.ot'), `${ui.accent(identity.name)} ${ui.gray(`· ${identity.role}`)}`],
+    [t('w.sum.home'), homeLabel || '—'],
+    [t('w.sum.brain'), brainLabel],
+    [t('w.sum.voice'), short(t(`w.voice.${cfg.voice.kind}`))],
+    [t('w.sum.pet'), `${short(t(`mode.${cfg.pet.mode}`))} ${ui.gray('·')} ${short(t(`w.annoy.${cfg.pet.annoy}`))}`],
+    [t('w.sum.hooks'), hooks.join(', ') || '—'],
+    [t('w.sum.files'), ui.gray(pretty(homeFile('config.json')))],
+    ['', ui.gray(pretty(loadIdentity().file || identityPath({ global: true })))],
+  ]);
+
+  const launch = await ui.confirm(t('w.launch', { name: identity.name }), true, yesNo);
+  if (!launch) {
+    ui.outro(t('w.next'));
+    return null;
+  }
+  ui.outro(t('w.waking', { name: identity.name }));
+  return { launch, mode: cfg.pet.mode === 'ask' ? 'auto' : cfg.pet.mode };
+}
+
+async function orquestaLogin() {
+  if (!(await ui.confirm(t('w.orqLogin'), true, [t('yes'), t('no')]))) return false;
+  const { login } = await import('./orquesta.mjs');
+  const { openUrl } = await import('./open.mjs');
+  let stop = () => {};
+  try {
+    const r = await login({
+      open: openUrl,
+      onWaiting: (url) => {
+        ui.note(t('login.open', { url }));
+        stop = ui.spinner(t('w.waitingBrowser'));
+      },
+    });
+    stop(t('login.ok', { org: r.organizationName || r.organizationId }));
+    return true;
+  } catch (e) {
+    stop();
+    ui.warn(e.message);
+    return false;
+  }
+}
+
+async function orquestaHome(prev) {
+  if (!hasKey('ORQUESTA_TOKEN') && !(await orquestaLogin())) return { kind: 'local' };
+  const { projects } = await import('./orquesta.mjs');
+  let list = [];
+  const stop = ui.spinner(t('w.loading'));
+  try {
+    list = (await projects()).projects;
+    stop();
+  } catch (e) {
+    stop();
+    ui.warn(`${ORQUESTA_URL}: ${e.message}`);
+  }
+  if (!list.length) {
+    ui.warn(t('w.orqNone'));
+    return { kind: 'local' };
+  }
+  const id = await ui.select(t('w.orqProject'), list.slice(0, 30).map((p) => [p.id, p.name, p.slug || '']), prev.projectId || list[0].id);
+  const p = list.find((x) => x.id === id);
+  return { kind: 'orquesta', projectId: p.id, projectName: p.name };
+}

package/cli/pet/electron/main.cjs

@@ -0,0 +1,86 @@
+/**
+ * Desktop mode: the pet page in a transparent, frameless, always-on-top window that strolls
+ * along the bottom of the screen. Launched by `7ots pet --mode desktop` with
+ *   npx -y electron@<v> cli/pet/electron/main.cjs
+ * and SEVENOTS_PET_URL / SEVENOTS_PET_TOKEN in the environment. Right click = menu.
+ */
+
+const { app, BrowserWindow, Menu, screen } = require('electron');
+
+const URL_ = process.env.SEVENOTS_PET_URL;
+const TOKEN = process.env.SEVENOTS_PET_TOKEN;
+const W = 240;
+const H = 270;
+
+app.commandLine.appendSwitch('enable-transparent-visuals'); // Linux compositors
+app.commandLine.appendSwitch('autoplay-policy', 'no-user-gesture-required'); // it talks without a click
+
+const post = (path, body) =>
+  fetch(new URL(path, URL_), { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-7ots-Token': TOKEN }, body: JSON.stringify(body || {}) }).catch(() => {});
+
+app.whenReady().then(() => {
+  const area = screen.getPrimaryDisplay().workArea;
+  let x = area.x + Math.round(area.width * 0.7);
+  const y = area.y + area.height - H;
+  const win = new BrowserWindow({
+    width: W,
+    height: H,
+    x,
+    y,
+    transparent: true,
+    frame: false,
+    resizable: false,
+    hasShadow: false,
+    alwaysOnTop: true,
+    skipTaskbar: true,
+    backgroundColor: '#00000000',
+    webPreferences: { contextIsolation: true, sandbox: true },
+  });
+  win.setAlwaysOnTop(true, 'floating');
+  win.setVisibleOnAllWorkspaces?.(true);
+  win.loadURL(`${URL_}/pet?desktop=1&token=${encodeURIComponent(TOKEN)}`);
+  win.webContents.setWindowOpenHandler(() => ({ action: 'deny' }));
+  win.webContents.on('will-navigate', (e) => e.preventDefault());
+
+  const menu = Menu.buildFromTemplate([
+    { label: '🍎 Feed', click: () => post('/event', { type: 'feed' }) },
+    { label: '🎾 Play', click: () => post('/event', { type: 'play' }) },
+    { label: '💤 Sleep', click: () => post('/event', { type: 'sleep' }) },
+    { label: '☀️ Wake up', click: () => post('/event', { type: 'wake' }) },
+    { type: 'separator' },
+    { label: 'Stay still', type: 'checkbox', checked: false, click: (i) => (still = i.checked) },
+    { label: 'Hide (keeps running)', click: () => app.quit() },
+    { label: 'Quit pet', click: () => post('/quit').finally(() => app.quit()) },
+  ]);
+  win.webContents.on('context-menu', () => menu.popup({ window: win }));
+
+  // Walk: a few seconds walking, a few standing, turn at the edges.
+  let dir = -1;
+  let walking = false;
+  let still = false;
+  let dragged = 0;
+  let lastSet = x;
+  win.on('moved', () => {
+    if (Math.abs(win.getPosition()[0] - lastSet) > 4) dragged = Date.now(); // the user dragged it
+  });
+  const tell = () => win.webContents.executeJavaScript(`postMessage({ walk: ${walking ? dir : 0} })`).catch(() => {});
+  setInterval(() => {
+    walking = !still && Math.random() < 0.45;
+    if (Math.random() < 0.3) dir = -dir;
+    tell();
+  }, 4000);
+  setInterval(() => {
+    if (!walking || still || Date.now() - dragged < 8000 || win.isDestroyed()) return;
+    const [cx, cy] = win.getPosition();
+    x = cx + dir * 2;
+    if (x < area.x || x > area.x + area.width - W) {
+      dir = -dir;
+      tell();
+      return;
+    }
+    lastSet = x;
+    win.setPosition(x, cy);
+  }, 40);
+});
+
+app.on('window-all-closed', () => app.quit());