sideby 0.11.0 → 0.12.1

package/dist/src/panel/i18n.d.ts

@@ -8,6 +8,39 @@ declare const en: {
     'top.updatedTitle': string;
     'top.language': string;
     'foot.text': string;
+    'foot.textChecks': string;
+    'upd.label': string;
+    'upd.labelLong': string;
+    'upd.title': string;
+    'upd.loading': string;
+    'upd.current': string;
+    'upd.available': string;
+    'upd.notes': string;
+    'upd.runs': string;
+    'upd.after': string;
+    'upd.cannot': string;
+    'upd.skill': string;
+    'upd.checksOff': string;
+    'upd.latest': string;
+    'upd.latestNow': string;
+    'upd.check': string;
+    'upd.checking': string;
+    'upd.verTitle': string;
+    'upd.checked': string;
+    'upd.notYet': string;
+    'upd.auto': string;
+    'upd.autoHint': string;
+    'upd.autoNo': string;
+    'upd.autoChange': string;
+    'upd.save': string;
+    'upd.changed': string;
+    'upd.autoOnSaved': string;
+    'upd.autoOffSaved': string;
+    'upd.now': string;
+    'upd.updating': string;
+    'upd.done': string;
+    'upd.reloading': string;
+    'upd.restartHint': string;
     'acct.title': string;
     'theme.system': string;
     'theme.light': string;

package/dist/src/panel/i18n.js

@@ -10,6 +10,39 @@ const en = {
     'top.updatedTitle': 'Last loaded at {at}. Refreshes on its own every {s} s while this page is open.',
     'top.language': 'Switch language',
     'foot.text': 'runs on this machine; nothing leaves it.',
+    'foot.textChecks': 'runs on this machine; once a day it asks npm for the newest sideby version, nothing else leaves it.',
+    'upd.label': 'v{v} available',
+    'upd.labelLong': 'sideby {v} is available (you have {cur}). Click to see what updating does.',
+    'upd.title': 'sideby updates',
+    'upd.loading': 'Loading…',
+    'upd.current': 'You have sideby {v}.',
+    'upd.available': 'sideby {v} is available.',
+    'upd.notes': 'What changed',
+    'upd.runs': 'Updating runs:',
+    'upd.after': 'A background panel restarts by itself and this page reloads. A sideby ui running in a terminal and sessions already running keep the old version until you restart them.',
+    'upd.cannot': 'sideby cannot update itself here: {why}. Run this yourself:',
+    'upd.skill': 'If you use the sideby skill, update it too:',
+    'upd.checksOff': 'Update checks are off ({why}).',
+    'upd.latest': 'This is the newest version',
+    'upd.latestNow': 'You have the newest version (checked just now).',
+    'upd.check': 'Check for updates',
+    'upd.checking': 'Checking…',
+    'upd.verTitle': 'sideby {v} · check for updates',
+    'upd.checked': 'checked {ago}',
+    'upd.notYet': 'sideby has not checked for a new version yet. It checks once a day.',
+    'upd.auto': 'Update by itself',
+    'upd.autoHint': 'Installs a new version after the daily check, when no sideby session is running. Never a major version.',
+    'upd.autoNo': 'Not available for this install: sideby cannot update itself here.',
+    'upd.autoChange': 'Sets update.auto to {value} in {file}.',
+    'upd.save': 'Save',
+    'upd.changed': 'A newer version, {v}, came out while this was open. Nothing was installed; look again and update.',
+    'upd.autoOnSaved': 'sideby now updates by itself',
+    'upd.autoOffSaved': 'sideby no longer updates by itself',
+    'upd.now': 'Update to {v}',
+    'upd.updating': 'Updating…',
+    'upd.done': 'Updated to sideby {v}.',
+    'upd.reloading': 'Waiting for the new version; this page reloads by itself.',
+    'upd.restartHint': 'This page still runs the old version. Restart sideby ui (or reload the page in your portal) to use the new one.',
     'acct.title': 'Accounts',
     'theme.system': 'Theme: follow system',
     'theme.light': 'Theme: light',
@@ -519,6 +552,39 @@ const zh = {
     'top.updatedTitle': '上次加载于 {at}。页面打开时每 {s} 秒自动刷新。',
     'top.language': '切换语言',
     'foot.text': '只在本机运行，数据不会离开这台电脑。',
+    'foot.textChecks': '只在本机运行；每天向 npm 查一次 sideby 最新版本号，除此之外没有数据离开这台电脑。',
+    'upd.label': 'v{v} 可更新',
+    'upd.labelLong': 'sideby {v} 已发布（当前 {cur}）。点击查看更新会做什么。',
+    'upd.title': 'sideby 更新',
+    'upd.loading': '加载中…',
+    'upd.current': '当前版本 sideby {v}。',
+    'upd.available': 'sideby {v} 已发布。',
+    'upd.notes': '更新内容',
+    'upd.runs': '更新会运行：',
+    'upd.after': '后台面板会自己重启，本页随后自动刷新。终端里运行的 sideby ui 和已经在跑的会话要重启后才用新版本。',
+    'upd.cannot': '这种安装方式下 sideby 不能自己更新：{why}。请自己运行：',
+    'upd.skill': '如果你装了 sideby skill，也更新一下：',
+    'upd.checksOff': '检查更新已关闭（{why}）。',
+    'upd.latest': '已是最新版本',
+    'upd.latestNow': '已是最新版本（刚刚检查）。',
+    'upd.check': '检查更新',
+    'upd.checking': '正在检查…',
+    'upd.verTitle': '当前 sideby {v} · 检查更新',
+    'upd.checked': '{ago}检查',
+    'upd.notYet': 'sideby 还没检查过新版本，每天检查一次。',
+    'upd.auto': '自动更新',
+    'upd.autoHint': '每天检查后，在没有 sideby 会话运行时安装新版本。不会自动装大版本。',
+    'upd.autoNo': '这种安装方式不支持：sideby 不能自己更新。',
+    'upd.autoChange': '会把 {file} 里的 update.auto 改成 {value}。',
+    'upd.save': '保存',
+    'upd.changed': '对话框打开期间又发布了新版本 {v}。什么都没安装；请再确认一次后更新。',
+    'upd.autoOnSaved': '已开启自动更新',
+    'upd.autoOffSaved': '已关闭自动更新',
+    'upd.now': '更新到 {v}',
+    'upd.updating': '更新中…',
+    'upd.done': '已更新到 sideby {v}。',
+    'upd.reloading': '等待新版本启动，本页会自动刷新。',
+    'upd.restartHint': '本页仍在运行旧版本。重启 sideby ui（在 Portal 里就刷新页面）后使用新版本。',
     'acct.title': '账号',
     'theme.system': '主题：跟随系统',
     'theme.light': '主题：浅色',

package/dist/src/panel/page-script.js

@@ -254,6 +254,7 @@ const MAIN = String.raw `
     check: 'M9 12l2 2 4-4M12 21a9 9 0 1 0 0-18 9 9 0 0 0 0 18z',
     userPlus: 'M15 19a6 6 0 0 0-12 0M9 11a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM19 8v6M16 11h6',
     x: 'M6 6l12 12M18 6L6 18',
+    arrowUp: 'M12 19V5M5 12l7-7 7 7',
     bot: 'M6 9h12a2 2 0 0 1 2 2v6a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-6a2 2 0 0 1 2-2zM12 5v4M9.5 13.5v1M14.5 13.5v1',
     grid: 'M4 4h7v7H4zM13 4h7v7h-7zM4 13h7v7H4zM13 13h7v7h-7z',
     list: 'M9 6h11M9 12h11M9 18h11M4 6h.01M4 12h.01M4 18h.01',
@@ -633,6 +634,9 @@ const MAIN = String.raw `
   function renderTop() {
     renderUpdated()
     renderHandoffButton()
+    renderUpdateButton()
+    const u = updState()
+    $('foot-text').textContent = t(u && !u.checksOff ? 'foot.textChecks' : 'foot.text')
     // A background refresh keeps the button still; only one the viewer asked for spins it.
     const busy = S.loading && !S.silent
     const refresh = $('refresh')
@@ -2674,8 +2678,169 @@ const MAIN = String.raw `
     if (Date.now() - S.lastTry > 3000) load({ silent: true })
   }
 
+  // ---------- updates (spec §3.23, ADR-0021) ----------
+  // A label in the header only when a newer sideby exists; the footer version opens the same dialog any time, with
+  // the Auto Update switch. Updating is one plan shown first and one click; afterwards the page waits for the new
+  // build and reloads (a background Panel restarts itself, a Portal loads the new code by itself).
+  let up = null
+  function updState() { return BOOT.updates && S.state ? S.state.update || null : null }
+  function renderUpdateButton() {
+    const b = $('update')
+    const u = updState()
+    // The version the page runs, a pill after the name; it opens the same dialog (with "Check for updates"), and
+    // takes a dot while a newer version waits.
+    const v = $('ver-top')
+    v.hidden = !BOOT.version
+    if (!v.hidden) {
+      const newer = !!(u && u.available)
+      v.textContent = 'v' + BOOT.version
+      v.classList.toggle('has-update', newer)
+      v.disabled = !BOOT.updates
+      const tip = !BOOT.updates ? '' : newer ? t('upd.labelLong', { v: u.latest, cur: u.current }) : t('upd.verTitle', { v: BOOT.version })
+      v.title = tip
+      if (tip) v.setAttribute('aria-label', tip)
+      else v.removeAttribute('aria-label')
+    }
+    b.hidden = !(u && u.available)
+    if (!b.hidden) {
+      setKids(b, [icon('arrowUp'), h('span', null, t('upd.label', { v: u.latest }))])
+      b.setAttribute('aria-label', t('upd.labelLong', { v: u.latest, cur: u.current }))
+      b.title = t('upd.labelLong', { v: u.latest, cur: u.current })
+    }
+    if (dlg.kind === 'update' && up && !up.busy) renderUpdate()
+  }
+  function openUpdate() {
+    if (!BOOT.updates) return
+    up = { busy: false, error: null, done: null, changed: false, autoPlan: null, autoBusy: false, waitUntil: 0, checking: false, checked: false }
+    showDialog('update')
+    renderUpdate()
+  }
+  async function updRun() {
+    const u = updState()
+    if (!u) return
+    up.busy = true
+    dlg.busy = true
+    up.error = null
+    renderUpdate()
+    try {
+      const r = await api('/api/update', { confirm: true, version: u.latest })
+      if (!r.updated) {
+        // The registry names another version than the dialog showed: show the new plan and let the person look again.
+        Object.assign(S.state.update, { latest: r.latest, available: r.available, command: r.command, canRun: r.canRun, releaseNotes: r.releaseNotes, method: r.method })
+        up.changed = true
+      } else {
+        up.done = r
+        up.waitUntil = Date.now() + 20000
+        updWait()
+      }
+    } catch (e) { up.error = e }
+    up.busy = false
+    dlg.busy = false
+    renderUpdate()
+  }
+  // "Check for updates": asks the registry now (the daily check only runs once a day), then shows the answer.
+  async function updCheck() {
+    up.checking = true
+    up.error = null
+    renderUpdate()
+    try {
+      await api('/api/update', {})
+      await load({ silent: true })
+      up.checked = true
+    } catch (e) { up.error = e }
+    up.checking = false
+    renderUpdate()
+  }
+  // After an Update the server (or the Portal's worker) comes back with a new build; load() then reloads the page.
+  function updWait() {
+    if (!up || !up.done || S.newBuild) { if (S.newBuild) location.reload(); return }
+    if (Date.now() > up.waitUntil) { renderUpdate(); return }
+    setTimeout(() => { void load({ silent: true }).then(updWait) }, 1500)
+  }
+  async function updAuto(on) {
+    up.autoBusy = true
+    up.error = null
+    renderUpdate()
+    try {
+      const r = await api('/api/update/settings', { auto: on })
+      up.autoPlan = r.changed ? { auto: on, file: r.file } : null
+    } catch (e) { up.error = e }
+    up.autoBusy = false
+    renderUpdate()
+  }
+  async function updAutoSave() {
+    if (!up.autoPlan) return
+    up.autoBusy = true
+    renderUpdate()
+    try {
+      await api('/api/update/settings', { auto: up.autoPlan.auto, confirm: true })
+      toast(t(up.autoPlan.auto ? 'upd.autoOnSaved' : 'upd.autoOffSaved'))
+      up.autoPlan = null
+      await load({ silent: true })
+    } catch (e) { up.error = e }
+    up.autoBusy = false
+    renderUpdate()
+  }
+  function renderUpdate() {
+    if (!up || dlg.kind !== 'update') return
+    const u = updState()
+    const body = []
+    if (!u) {
+      body.push(h('p', { class: 'muted' }, spinner(), ' ', t('upd.loading')))
+      setKids(dlg.el, dialogFrame(t('upd.title'), null, body, null))
+      return
+    }
+    body.push(h('p', null, t('upd.current', { v: u.current })))
+    if (up.done) {
+      body.push(h('p', { class: 'note' }, t('upd.done', { v: up.done.latest })))
+      body.push(h('p', { class: 'muted small' }, Date.now() > up.waitUntil ? t('upd.restartHint') : [spinner(), ' ', t('upd.reloading')]))
+      body.push(h('p', { class: 'small' }, t('upd.skill')), codeCopy(u.skill))
+    } else if (u.available) {
+      if (up.changed) body.push(h('p', { class: 'note note-warn' }, t('upd.changed', { v: u.latest })))
+      body.push(h('p', null, h('b', null, t('upd.available', { v: u.latest })), ' ',
+        h('a', { href: u.releaseNotes, target: '_blank', rel: 'noopener noreferrer' }, t('upd.notes'))))
+      if (u.canRun) {
+        body.push(h('p', { class: 'small' }, t('upd.runs')), codeCopy(u.command))
+        body.push(h('p', { class: 'muted small' }, t('upd.after')))
+      } else {
+        body.push(h('p', { class: 'note note-warn' }, t('upd.cannot', { why: u.method.reason || u.method.kind })))
+        body.push(codeCopy(u.command))
+      }
+      body.push(h('p', { class: 'small' }, t('upd.skill')), codeCopy(u.skill))
+    } else if (up.checked && u.latest) {
+      body.push(h('p', { class: 'note' }, t('upd.latestNow')))
+    } else if (u.checksOff) {
+      body.push(h('p', { class: 'muted small' }, t('upd.checksOff', { why: u.checksOff })))
+    } else if (u.latest) {
+      body.push(h('p', { class: 'muted small' }, t('upd.latest') + (u.checkedAt ? ' · ' + t('upd.checked', { ago: ago(u.checkedAt) }) : '')))
+    } else body.push(h('p', { class: 'muted small' }, t('upd.notYet')))
+    // A read-only Panel sends no request and writes nothing, so it cannot check (spec §3.23).
+    if (!BOOT.readOnly && !up.done && !u.available)
+      body.push(h('p', null, h('button', { class: 'btn btn-sm', type: 'button', disabled: up.checking || up.busy, 'aria-busy': up.checking ? 'true' : null, onclick: updCheck },
+        up.checking ? spinner() : icon('refresh'), up.checking ? t('upd.checking') : t('upd.check'))))
+    if (!BOOT.readOnly && !up.done) {
+      const box = h('input', { type: 'checkbox', disabled: up.autoBusy || !u.method.canUpdate })
+      box.checked = up.autoPlan ? up.autoPlan.auto : u.auto
+      box.addEventListener('change', () => updAuto(box.checked))
+      body.push(h('div', { class: 'check-row' }, h('label', { class: 'check' }, box,
+        h('span', null, h('b', null, t('upd.auto')), h('span', { class: 'muted small' }, u.method.canUpdate ? t('upd.autoHint') : t('upd.autoNo'))))))
+      if (up.autoPlan) body.push(h('p', { class: 'small' }, t('upd.autoChange', { file: up.autoPlan.file, value: String(up.autoPlan.auto) }), ' ',
+        h('button', { class: 'btn btn-sm btn-primary', type: 'button', disabled: up.autoBusy, onclick: updAutoSave }, t('upd.save'))))
+    }
+    if (BOOT.readOnly) body.push(h('p', { class: 'note' }, t('banner.readOnly')))
+    if (up.error) body.push(errorNote(up.error, null))
+    const foot = [h('button', { class: 'btn', type: 'button', disabled: up.busy, onclick: () => dlg.el.close() }, t('btn.close'))]
+    if (u.available && u.canRun && !BOOT.readOnly && !up.done)
+      foot.push(h('button', { class: 'btn btn-primary', type: 'button', disabled: up.busy, 'aria-busy': up.busy ? 'true' : null, onclick: updRun }, up.busy ? spinner() : null, up.busy ? t('upd.updating') : t('upd.now', { v: u.latest })))
+    setKids(dlg.el, dialogFrame(t('upd.title'), null, body, foot))
+  }
+
   // ---------- start ----------
-  $('ver').textContent = BOOT.version ? 'v' + BOOT.version : ''
+  $('ver').textContent = BOOT.version ? 'sideby v' + BOOT.version : 'sideby'
+  $('ver').disabled = !BOOT.updates
+  $('ver').addEventListener('click', openUpdate)
+  $('update').addEventListener('click', openUpdate)
+  $('ver-top').addEventListener('click', openUpdate)
   $('refresh').addEventListener('click', () => load({ check: true, announce: true }))
   $('handoff').addEventListener('click', () => setPage('handoff'))
   $('lang').addEventListener('click', () => {
@@ -2690,6 +2855,7 @@ const MAIN = String.raw `
     else if (dlg.kind === 'setup' && qs) renderSetup()
     else if (dlg.kind === 'tune' && tuneState) renderTune()
     else if (dlg.kind === 'model' && md) { md.form = null; renderModel() }
+    else if (dlg.kind === 'update' && up) renderUpdate()
   })
   $('theme').addEventListener('click', () => {
     const order = CHOICES.theme

package/dist/src/panel/page-styles.js

@@ -1,7 +1,8 @@
 // The Panel page's styles: design tokens (a host theme layers its values over them, see theme.ts) and the rules
 // that read them. Every color, radius and size below comes from a token, so a host theme reaches every component.
 import { resolveTheme } from './theme.js';
-// Colors defined from other tokens; repeated in both schemes so they follow that scheme's base colors.
+// Colors defined from other tokens; repeated in both schemes so they follow that scheme's base colors. Dark mode keeps
+// the logo tile light: the mark's ink outline (core/brand-mark.ts) needs a light ground.
 const DERIVED_COLORS = `
   --btn-text: var(--text); --btn-hover-text: var(--accent); --check: var(--focus);
   --logo-bg: var(--accent-soft); --logo-fg: var(--focus); --logo-line: var(--border);
@@ -34,7 +35,8 @@ const DARK_TOKENS = `
   --ok: #4ade80; --ok-bar: #22c55e; --ok-soft: #13291c; --warn: #fbbf24; --warn-bar: #f59e0b; --warn-soft: #2d2410;
   --fail: #f87171; --fail-bar: #ef4444; --fail-soft: #331717; --track: #1f2c3a;
   --spark: oklch(from var(--accent) clamp(0.7, l, 0.78) max(c, 0.14) h); --spark-soft: oklch(from var(--accent) 0.45 calc(max(c, 0.14) * 0.6) h);
-  --shadow: 0 1px 2px rgba(0,0,0,.3); --float-shadow: 0 12px 32px rgba(0,0,0,.5), 0 2px 6px rgba(0,0,0,.3);${DERIVED_COLORS}`;
+  --shadow: 0 1px 2px rgba(0,0,0,.3); --float-shadow: 0 12px 32px rgba(0,0,0,.5), 0 2px 6px rgba(0,0,0,.3);${DERIVED_COLORS}
+  --logo-bg: #dcebf7; --logo-line: transparent;`;
 /**
  * The page's style block: default tokens, the host's tokens over them, then the rules that read them. With
  * `colorScheme: 'auto'` the page follows the system unless the viewer picked light or dark in the Panel, which sets
@@ -61,6 +63,9 @@ body { margin: 0; background: var(--bg); color: var(--text); font: var(--font-si
 [hidden] { display: none !important; }
 .top-in, .wrap { max-width: var(--content-width); margin: 0 auto; }
 .top-in { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 28px var(--gutter) 0; }
+/* When the name, its version pill and the buttons do not fit one row, the buttons wrap below, on the right. */
+.top-in { flex-wrap: wrap; row-gap: 10px; }
+.top-in > .top-actions { margin-left: auto; flex-wrap: wrap; justify-content: flex-end; }
 .wrap { padding: 20px var(--gutter) 40px; }
 .header-bar .top { background: var(--surface); border-bottom: 1px solid var(--border); }
 .header-bar .top-in { min-height: 84px; padding: 14px var(--gutter); }
@@ -80,6 +85,14 @@ code, .mono { font-family: var(--mono); font-size: 0.92em; }
 .brand { display: flex; align-items: center; gap: 12px; min-width: 0; }
 .brand h1 { font-size: var(--title-size); font-weight: var(--title-weight); line-height: 1.3; letter-spacing: -0.02em; }
 .tagline { color: var(--muted); font-size: 13px; }
+/* The running version, a quiet pill after the name; with a newer version it takes the accent and a dot (spec §3.23). */
+.title-row { display: flex; align-items: center; gap: 8px; min-width: 0; }
+.ver-pill { display: inline-flex; align-items: center; gap: 5px; padding: 1px 8px; border: 1px solid var(--border); border-radius: 999px; background: var(--surface); color: var(--muted); font: 500 11.5px/18px var(--mono); cursor: pointer; white-space: nowrap; }
+.ver-pill:hover:not(:disabled) { color: var(--accent); border-color: var(--accent); }
+.ver-pill:disabled { cursor: default; }
+.ver-pill:focus-visible { outline: var(--focus-outline); outline-offset: 2px; }
+.ver-pill.has-update { color: var(--accent); border-color: var(--accent); background: var(--accent-soft); }
+.ver-pill.has-update::before { content: ""; width: 6px; height: 6px; border-radius: 50%; background: var(--accent); }
 .logo { display: inline-flex; flex: none; width: 40px; height: 40px; border-radius: 10px; background: var(--logo-bg); box-shadow: inset 0 0 0 1px var(--logo-line); }
 /* desktop/icon.ts draws the same two half discs for the app icon. */
 .logo svg { display: block; width: 100%; height: 100%; fill: var(--logo-fg); }
@@ -221,6 +234,8 @@ code, .mono { font-family: var(--mono); font-size: 0.92em; }
 .link-btn { padding: 0; border: 0; background: none; color: var(--accent); font: inherit; font-weight: var(--strong-weight); cursor: pointer; }
 .link-btn:hover:not(:disabled) { text-decoration: underline; }
 .link-btn:disabled { color: var(--faint); cursor: not-allowed; }
+.foot .link-btn { color: inherit; font-weight: inherit; }
+.update-btn { border-color: var(--accent); color: var(--accent); }
 .link-btn:focus-visible { outline: var(--focus-outline); outline-offset: 2px; border-radius: 3px; }
 
 /* Usage: total over cache hits, with the 7 day bars beside both lines. In the wide list the bars sit at the column's
@@ -555,6 +570,7 @@ select:is(:hover, :focus) { --chevron: var(--text); }
   :root { --gutter: 14px; }
   .top-in { padding: 16px var(--gutter) 0; }
   .header-bar .top-in { min-height: 0; padding: 12px var(--gutter); }
+  .update-btn span { display: none; }
   .wrap { padding: 14px var(--gutter) 32px; }
   .hide-sm { display: none; }
   .tagline { display: none; }

package/dist/src/panel/page.d.ts

@@ -14,6 +14,8 @@ export interface PageOptions {
     theme?: ResolvedTheme;
     /** Host language from createPanelHandler's `lang`; `auto` (the default) lets the viewer choose. */
     lang?: 'auto' | 'en' | 'zh';
+    /** createPanelHandler's `updates`: false hides everything about sideby updates. */
+    updates?: boolean;
 }
 /** JSON that is safe inside a `<script>` element: no `</script>`, `<!--` or line separators survive. */
 export declare function jsonForScript(value: unknown): string;

package/dist/src/panel/page.js

@@ -34,6 +34,7 @@ export function renderPage(opts) {
         version: opts.version ?? '',
         build: opts.build ?? '',
         readOnly: Boolean(opts.readOnly),
+        updates: opts.updates !== false,
         colorScheme: theme.colorScheme,
         lang,
         warn: QUOTA_WARN_PERCENT,
@@ -51,7 +52,7 @@ export function renderPage(opts) {
 <meta name="color-scheme" content="${scheme}">
 <meta name="referrer" content="no-referrer">
 <title>sideby</title>
-<link rel="icon" href="data:,">
+<link rel="icon" type="image/svg+xml" href="${attr(opts.basePath)}/favicon.svg">
 <style${nonce}>${pageStyles(theme)}</style>
 </head>
 <body${theme.header === 'bar' ? ' class="header-bar"' : ''}>
@@ -60,7 +61,7 @@ export function renderPage(opts) {
     <div class="brand">
       <span class="logo" aria-hidden="true">${MARK_SVG}</span>
       <div>
-        <h1>sideby</h1>
+        <div class="title-row"><h1>sideby</h1><button id="ver-top" class="ver-pill" type="button" hidden></button></div>
         <p class="tagline" data-i18n="top.tagline">Every AI coding account, side by side.</p>
       </div>
     </div>
@@ -68,6 +69,7 @@ export function renderPage(opts) {
       <span id="updated" class="muted small">Loading…</span>
       <button id="lang" class="icon-btn lang-btn" type="button"${lang === 'auto' ? '' : ' hidden'}>${lang === 'zh' ? 'EN' : '中文'}</button>
       <button id="theme" class="icon-btn" type="button" hidden></button>
+      <button id="update" class="btn update-btn" type="button" hidden></button>
       <button id="handoff" class="btn" type="button" hidden></button>
       <button id="refresh" class="btn" type="button" aria-label="Refresh"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M20 11a8 8 0 1 0-2.3 5.7"/><path d="M20 4v7h-7"/></svg><span class="hide-sm" data-i18n="top.refresh">Refresh</span></button>
     </div>
@@ -88,7 +90,7 @@ export function renderPage(opts) {
     <div class="section-head"><h2 id="h-checkup" data-i18n="health.title">Health check</h2></div>
     <span class="sk sk-line w70"></span><span class="sk sk-line w50"></span>
   </section>
-  <footer class="foot muted small">sideby <span id="ver"></span> · <span data-i18n="foot.text">runs on this machine; nothing leaves it.</span></footer>
+  <footer class="foot muted small"><button id="ver" class="link-btn" type="button">sideby</button> · <span id="foot-text" data-i18n="foot.text">runs on this machine; nothing leaves it.</span></footer>
 </main>
 <div id="conn" class="conn" role="status" hidden></div>
 <div id="toasts" class="toasts" aria-live="polite" popover="manual"></div>

package/dist/testing/index.js

@@ -19,6 +19,8 @@ export async function withFakeHome(fn) {
         XDG_STATE_HOME: join(home, '.local', 'state'),
         PATH: `${bin}:/usr/bin:/bin`,
         NO_COLOR: '1',
+        // No Update Check from tests (spec §3.23): it is sideby's only network request. Delete it to test checks.
+        SIDEBY_NO_UPDATE_NOTIFIER: '1',
     };
     const h = {
         home,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sideby",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "Run work, personal and API-key accounts at the same time, without their configs drifting apart.",
   "license": "MIT",
   "author": "Adonis0123 (https://github.com/Adonis0123)",
@@ -77,5 +77,5 @@
   },
   "packageManager": "pnpm@10.15.0",
   "readmeFilename": "README.md",
-  "readme": "<p align=\"center\">\n  <img alt=\"sideby: work, personal and API-key accounts, one terminal each, one shared config\" src=\"https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/banner.jpg\" width=\"880\">\n</p>\n\n<p align=\"center\">\n  <b>Run work, personal and API-key accounts at the same time, without their configs drifting apart.</b><br>\n  Each account is its own directory and its own terminal. Skills, hooks and settings stay linked to your main account. Claude Code, Codex, Grok Build and pi.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/sideby\"><img alt=\"npm\" src=\"https://img.shields.io/npm/v/sideby\"></a>\n  <a href=\"https://github.com/Adonis0123/sideby/actions/workflows/ci.yml\"><img alt=\"CI\" src=\"https://github.com/Adonis0123/sideby/actions/workflows/ci.yml/badge.svg\"></a>\n  <img alt=\"Node 22.18+\" src=\"https://img.shields.io/badge/node-%E2%89%A522.18-339933\">\n  <a href=\"LICENSE\"><img alt=\"MIT\" src=\"https://img.shields.io/badge/license-MIT-blue\"></a>\n</p>\n\n<p align=\"center\">English | <a href=\"README.zh-CN.md\">中文</a></p>\n\n## Quick start\n\nRequires Node 22.18+ and at least one Host CLI (Claude Code, Codex, Grok Build or pi) installed. AI agents: follow the setup steps in [`llms.txt`](llms.txt) (\"Set up sideby for a user\") instead.\n\n```sh\nnpm i -g sideby\nsideby new claude work           # create ~/.claude-work, sharing ~/.claude's skills and hooks\nsideby login claude:work         # sign in once\nsideby run work                  # Claude Code on the work account\nsideby quota setup claude --yes  # Claude quota in the panel; undo: sideby quota teardown claude\nsideby ui                        # every account's quota at http://127.0.0.1:17420\n```\n\n`sideby run claude:main` keeps using `~/.claude` in another terminal at the same time. Arguments after `--` go to the Host: `sideby run work -- --resume`. To try it without installing, run `npx sideby`.\n\n## Set up with your AI agent\n\nPaste this into Claude Code, Codex or any coding agent:\n\n```text\nInstall the sideby CLI (npm package `sideby`) and its agent skill, then set up a second Claude Code account for me.\nFollow \"Set up sideby for a user\" in https://raw.githubusercontent.com/Adonis0123/sideby/main/llms.txt\n```\n\nThe agent checks Node and your Host CLIs, installs sideby and the skill, creates the account, tells you what it shares with your main one and makes its short command work. You sign in once in your browser; the agent gives you that one command. Once the skill is installed, short requests work too: \"add another Claude account, cc008\", \"what do my Codex accounts share?\", \"which account still has quota?\".\n\n## What it looks like\n\nThe 25-second story: one account buried in tasks, then accounts side by side sharing one setup, and a task moving on when one runs out.\n\nhttps://github.com/user-attachments/assets/3a470c03-9009-4f1d-b7f6-8b4625d74958\n\n<img alt=\"Two terminals: the personal account and the work account running at the same time, both linked to the main account's skills and settings, then the local quota panel, and at 95% Auto Handoff moving work's session to the next account\" src=\"https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/demo.gif\" width=\"1280\">\n\n<picture>\n  <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/panel-dark.png\">\n  <source media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/panel.png\">\n  <img alt=\"sideby panel: every account's 5h and 7d quota, 7-day token usage and health in one page\" src=\"https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/panel.png\" width=\"1280\">\n</picture>\n\n## Why not just an alias?\n\n`CLAUDE_CONFIG_DIR` plus a shell alias already starts a second account. It does not keep skills and settings in one place, and it does not show quota for every account. [Does this break a provider's terms?](docs/guide/faq.md#terms)\n\n| | At the same time | Skills, hooks, settings | Quota and usage | Setup |\n|---|---|---|---|---|\n| `CLAUDE_CONFIG_DIR` and an alias | Yes. Each terminal exports the variable. | Each directory is its own copy. They drift unless you symlink by hand. | That session's status line | One alias per account |\n| [cc-switch](https://github.com/farion1231/cc-switch) | Enabling a provider writes the host's live config, so open sessions share that switch. | Plugin settings are copied across providers as a separate step. | The active provider, from its quota endpoint | Install the desktop app |\n| sideby | Yes. `sideby run` selects the directory for that process and leaves your shell alone. | Linked to the main account. `sideby doctor --fix` repairs copies. Sign-in and sessions stay separate. | Every account, from local files. Claude needs `quota setup`. | `npm i -g sideby`, then `sideby new` and sign in |\n\ncc-switch's docs describe that switch: it writes the live settings file ([README](https://github.com/farion1231/cc-switch#readme)). [#1105](https://github.com/farion1231/cc-switch/issues/1105) and [#2908](https://github.com/farion1231/cc-switch/issues/2908) ask for several sessions at once. [#1106](https://github.com/farion1231/cc-switch/issues/1106) is closed; the maintainer says Claude Code's \"open terminal\" can start one provider without changing the global config.\n\n## What else it does\n\n| You want to | Run | Guide |\n|---|---|---|\n| Add an API key account (DeepSeek, a gateway, …) | `sideby new claude deepseek --api` | [API accounts](docs/guide/usage.md#api-accounts) |\n| Find and fix config drift between accounts | `sideby doctor --fix` | [Doctor](docs/guide/usage.md#doctor) |\n| See Claude quota (Codex needs no setup) | `sideby quota setup claude --yes` | [Claude quota](docs/guide/usage.md#claude-quota) |\n| Find the cheapest auto-compact size from your own sessions, and use it in one click | `sideby tune` (or the panel's Context tuning tab) | [Context tuning](docs/guide/usage.md#context-tuning) |\n| See each account's model and effort, and set them per account | `sideby model <account>` (or click the model in the panel) | [Model and effort](docs/guide/usage.md#model-and-effort) |\n| Stop Claude sessions from connecting to claude.ai by themselves (Remote Control), for every account at once | `sideby remote-control off` (or the panel's banner) | [Remote Control](docs/guide/usage.md#remote-control) |\n| Move on when an account hits its limit | `sideby next claude` | [Handoff](docs/guide/usage.md#when-an-account-hits-its-limit) |\n| Let a running task move to the next account by itself when quota runs low (off by default; see the risk) | `sideby handoff enable` (or the panel) | [Auto Handoff](docs/guide/usage.md#auto-handoff) |\n| Short commands such as `ccw` | `sideby alias add ccw claude:work` | [Shell functions](docs/guide/configuration.md#shell-functions) |\n| Reopen a session from Orca and the like in the account that holds it | `\"resumeRouting\": true` in config | [Resuming from other tools](docs/guide/configuration.md#resuming-from-other-tools) |\n| Open Claude Desktop or the Codex app as one account, several side by side (macOS) | `sideby desktop claude:work` (or the panel) | [Desktop apps](docs/guide/usage.md#desktop-apps) |\n| Keep several Grok Bot windows open, each signed in to its own account (macOS) | `sideby desktop grok-bot:002` (or the panel) | [Grok Bot windows](docs/guide/usage.md#grok-bot-windows) |\n| Open the panel from the Dock or app menu | `sideby app install` | [Panel app](docs/guide/panel.md#panel-app) |\n| Show the panel inside your own local page | `createPanelHandler()` | [Embed the panel](docs/guide/panel.md#embed-the-panel) |\n| Add a Host or a pre-launch check | a local plugin | [Plugins](docs/guide/plugins.md) |\n\n## Supported hosts\n\n| Host | Account directories | Sign-in | Quota | Usage (7 days) |\n|---|---|---|---|---|\n| Claude Code | `~/.claude`, `~/.claude-<name>` | `claude auth login` | ✓ after `quota setup claude` | ✓ |\n| Codex CLI | `~/.codex`, `~/.codex-<name>` | `codex login` | ✓ | ✓ |\n| Grok Build | `~/.grok`, `~/.grok-<name>` | `grok login` | no public source | no public source |\n| pi | `~/.pi/agent`, `~/.pi-<name>/agent` | `/login` inside pi | no public source | no public source |\n\nsideby starts the official binary on your `PATH` and never patches it. Tested versions and per-Host notes are in the [guide](docs/guide/usage.md#host-notes).\n\n## Platforms\n\nmacOS and Linux. CI runs the suite on `ubuntu-latest` and `macos-latest`, Node 22 and 24. **Windows is untested.** `sideby app` only installs a launcher on macOS and Linux. Linked items are symlinks, `sideby shell-init` prints bash and zsh functions, and the Claude quota wrapper runs `/bin/sh`.\n\n## Roadmap\n\n**Gemini CLI.** Gemini can point at another config directory with `GEMINI_CONFIG_DIR`. Older docs use `GEMINI_CLI_HOME`; current builds treat that name as deprecated, and exit on startup if it is set together with an exact directory override. A sideby family still needs a tested Gemini version, a login check that does not read tokens, and a list of which files to link or copy. That is more than a small patch, so it is not in this version.\n\n## Safe by design\n\n- It never edits a Host's global config to switch accounts. It moves a task to another account only when you turn on Auto Handoff, and never proxies requests or pools logins.\n- It never reads, prints or sends a credential value. Nothing leaves your machine: sideby calls no remote service.\n- `doctor --fix` never replaces a real file and never changes where a link points.\n\nDetails and the terms-of-service question are in the [FAQ](docs/guide/faq.md).\n\nUsage questions and ideas go in [Discussions](https://github.com/Adonis0123/sideby/discussions).\n\n## Docs\n\n- [Using sideby](docs/guide/usage.md): accounts, API accounts, Doctor, quota, Handoff, Host notes\n- [Commands](docs/guide/commands.md): every command, exit codes and `--json`\n- [Configuration](docs/guide/configuration.md): `config.json`, aliases, shell functions\n- [Panel](docs/guide/panel.md): the panel, panel app and embedding\n- [Plugins](docs/guide/plugins.md): write your own Family or launch hook\n- [FAQ](docs/guide/faq.md): terms of service, data locations, alternatives, uninstall\n- [Changelog](https://github.com/Adonis0123/sideby/releases)\n\n## For AI agents\n\n- [`llms.txt`](llms.txt): setup steps, commands, JSON contract and plugin API in one index. `sideby families --json` states what each Host's accounts share.\n- [`skills/sideby/SKILL.md`](skills/sideby/SKILL.md): one Agent Skill for seeing, repairing and creating accounts and for moving on when one hits its limit. Install with `npx skills add Adonis0123/sideby -g`; `sideby doctor` warns when the installed copy is for another sideby version.\n- [`AGENTS.md`](AGENTS.md): rules for agents working on this repository.\n\n## License\n\n[MIT](LICENSE)\n"
+  "readme": "<p align=\"center\">\n  <img alt=\"sideby: work, personal and API-key accounts, one terminal each, one shared config\" src=\"https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/banner.jpg\" width=\"880\">\n</p>\n\n<p align=\"center\">\n  <b>Run work, personal and API-key accounts at the same time, without their configs drifting apart.</b><br>\n  Each account is its own directory and its own terminal. Skills, hooks and settings stay linked to your main account. Claude Code, Codex, Grok Build and pi.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/sideby\"><img alt=\"npm\" src=\"https://img.shields.io/npm/v/sideby\"></a>\n  <a href=\"https://github.com/Adonis0123/sideby/actions/workflows/ci.yml\"><img alt=\"CI\" src=\"https://github.com/Adonis0123/sideby/actions/workflows/ci.yml/badge.svg\"></a>\n  <img alt=\"Node 22.18+\" src=\"https://img.shields.io/badge/node-%E2%89%A522.18-339933\">\n  <a href=\"LICENSE\"><img alt=\"MIT\" src=\"https://img.shields.io/badge/license-MIT-blue\"></a>\n</p>\n\n<p align=\"center\">English | <a href=\"README.zh-CN.md\">中文</a></p>\n\n## Quick start\n\nRequires Node 22.18+ and at least one Host CLI (Claude Code, Codex, Grok Build or pi) installed. AI agents: follow the setup steps in [`llms.txt`](llms.txt) (\"Set up sideby for a user\") instead.\n\n```sh\nnpm i -g sideby\nsideby new claude work           # create ~/.claude-work, sharing ~/.claude's skills and hooks\nsideby login claude:work         # sign in once\nsideby run work                  # Claude Code on the work account\nsideby quota setup claude --yes  # Claude quota in the panel; undo: sideby quota teardown claude\nsideby ui                        # every account's quota at http://127.0.0.1:17420\n```\n\n`sideby update` installs a newer sideby when there is one; sideby says so after a command and in the panel. `sideby run claude:main` keeps using `~/.claude` in another terminal at the same time. Arguments after `--` go to the Host: `sideby run work -- --resume`. To try it without installing, run `npx sideby`.\n\n## Set up with your AI agent\n\nPaste this into Claude Code, Codex or any coding agent:\n\n```text\nInstall the sideby CLI (npm package `sideby`) and its agent skill, then set up a second Claude Code account for me.\nFollow \"Set up sideby for a user\" in https://raw.githubusercontent.com/Adonis0123/sideby/main/llms.txt\n```\n\nThe agent checks Node and your Host CLIs, installs sideby and the skill, creates the account, tells you what it shares with your main one and makes its short command work. You sign in once in your browser; the agent gives you that one command. Once the skill is installed, short requests work too: \"add another Claude account, cc008\", \"what do my Codex accounts share?\", \"which account still has quota?\".\n\n## What it looks like\n\nThe 25-second story: one account buried in tasks, then accounts side by side sharing one setup, and a task moving on when one runs out.\n\nhttps://github.com/user-attachments/assets/3a470c03-9009-4f1d-b7f6-8b4625d74958\n\n<img alt=\"Two terminals: the personal account and the work account running at the same time, both linked to the main account's skills and settings, then the local quota panel, and at 95% Auto Handoff moving work's session to the next account\" src=\"https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/demo.gif\" width=\"1280\">\n\n<picture>\n  <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/panel-dark.png\">\n  <source media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/panel.png\">\n  <img alt=\"sideby panel: every account's 5h and 7d quota, 7-day token usage and health in one page\" src=\"https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/panel.png\" width=\"1280\">\n</picture>\n\n## Why not just an alias?\n\n`CLAUDE_CONFIG_DIR` plus a shell alias already starts a second account. It does not keep skills and settings in one place, and it does not show quota for every account. [Does this break a provider's terms?](docs/guide/faq.md#terms)\n\n| | At the same time | Skills, hooks, settings | Quota and usage | Setup |\n|---|---|---|---|---|\n| `CLAUDE_CONFIG_DIR` and an alias | Yes. Each terminal exports the variable. | Each directory is its own copy. They drift unless you symlink by hand. | That session's status line | One alias per account |\n| [cc-switch](https://github.com/farion1231/cc-switch) | Enabling a provider writes the host's live config, so open sessions share that switch. | Plugin settings are copied across providers as a separate step. | The active provider, from its quota endpoint | Install the desktop app |\n| sideby | Yes. `sideby run` selects the directory for that process and leaves your shell alone. | Linked to the main account. `sideby doctor --fix` repairs copies. Sign-in and sessions stay separate. | Every account, from local files. Claude needs `quota setup`. | `npm i -g sideby`, then `sideby new` and sign in |\n\ncc-switch's docs describe that switch: it writes the live settings file ([README](https://github.com/farion1231/cc-switch#readme)). [#1105](https://github.com/farion1231/cc-switch/issues/1105) and [#2908](https://github.com/farion1231/cc-switch/issues/2908) ask for several sessions at once. [#1106](https://github.com/farion1231/cc-switch/issues/1106) is closed; the maintainer says Claude Code's \"open terminal\" can start one provider without changing the global config.\n\n## What else it does\n\n| You want to | Run | Guide |\n|---|---|---|\n| Add an API key account (DeepSeek, a gateway, …) | `sideby new claude deepseek --api` | [API accounts](docs/guide/usage.md#api-accounts) |\n| Find and fix config drift between accounts | `sideby doctor --fix` | [Doctor](docs/guide/usage.md#doctor) |\n| See Claude quota (Codex needs no setup) | `sideby quota setup claude --yes` | [Claude quota](docs/guide/usage.md#claude-quota) |\n| Find the cheapest auto-compact size from your own sessions, and use it in one click | `sideby tune` (or the panel's Context tuning tab) | [Context tuning](docs/guide/usage.md#context-tuning) |\n| See each account's model and effort, and set them per account | `sideby model <account>` (or click the model in the panel) | [Model and effort](docs/guide/usage.md#model-and-effort) |\n| Stop Claude sessions from connecting to claude.ai by themselves (Remote Control), for every account at once | `sideby remote-control off` (or the panel's banner) | [Remote Control](docs/guide/usage.md#remote-control) |\n| Move on when an account hits its limit | `sideby next claude` | [Handoff](docs/guide/usage.md#when-an-account-hits-its-limit) |\n| Let a running task move to the next account by itself when quota runs low (off by default; see the risk) | `sideby handoff enable` (or the panel) | [Auto Handoff](docs/guide/usage.md#auto-handoff) |\n| Short commands such as `ccw` | `sideby alias add ccw claude:work` | [Shell functions](docs/guide/configuration.md#shell-functions) |\n| Reopen a session from Orca and the like in the account that holds it | `\"resumeRouting\": true` in config | [Resuming from other tools](docs/guide/configuration.md#resuming-from-other-tools) |\n| Open Claude Desktop or the Codex app as one account, several side by side (macOS) | `sideby desktop claude:work` (or the panel) | [Desktop apps](docs/guide/usage.md#desktop-apps) |\n| Keep several Grok Bot windows open, each signed in to its own account (macOS) | `sideby desktop grok-bot:002` (or the panel) | [Grok Bot windows](docs/guide/usage.md#grok-bot-windows) |\n| Open the panel from the Dock or app menu | `sideby app install` | [Panel app](docs/guide/panel.md#panel-app) |\n| Show the panel inside your own local page | `createPanelHandler()` | [Embed the panel](docs/guide/panel.md#embed-the-panel) |\n| Add a Host or a pre-launch check | a local plugin | [Plugins](docs/guide/plugins.md) |\n\n## Supported hosts\n\n| Host | Account directories | Sign-in | Quota | Usage (7 days) |\n|---|---|---|---|---|\n| Claude Code | `~/.claude`, `~/.claude-<name>` | `claude auth login` | ✓ after `quota setup claude` | ✓ |\n| Codex CLI | `~/.codex`, `~/.codex-<name>` | `codex login` | ✓ | ✓ |\n| Grok Build | `~/.grok`, `~/.grok-<name>` | `grok login` | no public source | no public source |\n| pi | `~/.pi/agent`, `~/.pi-<name>/agent` | `/login` inside pi | no public source | no public source |\n\nsideby starts the official binary on your `PATH` and never patches it. Tested versions and per-Host notes are in the [guide](docs/guide/usage.md#host-notes).\n\n## Platforms\n\nmacOS and Linux. CI runs the suite on `ubuntu-latest` and `macos-latest`, Node 22 and 24. **Windows is untested.** `sideby app` only installs a launcher on macOS and Linux. Linked items are symlinks, `sideby shell-init` prints bash and zsh functions, and the Claude quota wrapper runs `/bin/sh`.\n\n## Roadmap\n\n**Gemini CLI.** Gemini can point at another config directory with `GEMINI_CONFIG_DIR`. Older docs use `GEMINI_CLI_HOME`; current builds treat that name as deprecated, and exit on startup if it is set together with an exact directory override. A sideby family still needs a tested Gemini version, a login check that does not read tokens, and a list of which files to link or copy. That is more than a small patch, so it is not in this version.\n\n## Safe by design\n\n- It never edits a Host's global config to switch accounts. It moves a task to another account only when you turn on Auto Handoff, and never proxies requests or pools logins.\n- It never reads, prints or sends a credential value. Nothing about your accounts leaves your machine: the only request sideby makes on its own is a daily check of the npm registry for its newest version (off with `NO_UPDATE_NOTIFIER=1`; see [Updates](docs/guide/configuration.md#updates)).\n- `doctor --fix` never replaces a real file and never changes where a link points.\n\nDetails and the terms-of-service question are in the [FAQ](docs/guide/faq.md).\n\nUsage questions and ideas go in [Discussions](https://github.com/Adonis0123/sideby/discussions).\n\n## Docs\n\n- [Using sideby](docs/guide/usage.md): accounts, API accounts, Doctor, quota, Handoff, Host notes\n- [Commands](docs/guide/commands.md): every command, exit codes and `--json`\n- [Configuration](docs/guide/configuration.md): `config.json`, aliases, shell functions\n- [Panel](docs/guide/panel.md): the panel, panel app and embedding\n- [Plugins](docs/guide/plugins.md): write your own Family or launch hook\n- [FAQ](docs/guide/faq.md): terms of service, data locations, alternatives, uninstall\n- [Changelog](https://github.com/Adonis0123/sideby/releases)\n\n## For AI agents\n\n- [`llms.txt`](llms.txt): setup steps, commands, JSON contract and plugin API in one index. `sideby families --json` states what each Host's accounts share.\n- [`skills/sideby/SKILL.md`](skills/sideby/SKILL.md): one Agent Skill for seeing, repairing and creating accounts and for moving on when one hits its limit. Install with `npx skills add Adonis0123/sideby -g`; `sideby doctor` warns when the installed copy is for another sideby version.\n- [`AGENTS.md`](AGENTS.md): rules for agents working on this repository.\n\n## License\n\n[MIT](LICENSE)\n"
 }

package/schemas/config.json

@@ -226,6 +226,21 @@
       },
       "additionalProperties": false
     },
+    "update": {
+      "type": "object",
+      "properties": {
+        "check": {
+          "type": "boolean",
+          "description": "Ask the npm registry once a day whether a newer sideby exists, and say so after a command and in the Panel. On by default; `NO_UPDATE_NOTIFIER` or `SIDEBY_NO_UPDATE_NOTIFIER` also turn it off."
+        },
+        "auto": {
+          "type": "boolean",
+          "description": "Install a newer version by itself after a check, when no `sideby run` is running and the version is not a major one. Off by default."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Update Check and Auto Update (ADR-0021)."
+    },
     "shellInitFile": {
       "type": "object",
       "properties": {