sideby 0.12.0 → 0.13.0

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

@@ -63,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); }
@@ -82,6 +85,19 @@ 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; }
+/* When the account data was read; the dot says whether it still refreshes on its own (green) or stopped (amber). */
+#updated { display: inline-flex; align-items: center; gap: 6px; }
+#updated.is-live::before, #updated.is-stale::before { content: ""; width: 7px; height: 7px; border-radius: 50%; background: var(--ok-bar); }
+#updated.is-stale::before { background: var(--warn-bar); }
+/* 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), .ver-pill[aria-expanded="true"] { color: var(--on-primary); border-color: var(--primary-hover-border); background: var(--primary-hover); }
+.ver-pill.has-update:hover:not(:disabled), .ver-pill.has-update[aria-expanded="true"] { color: var(--accent); border-color: var(--accent); background: var(--active); }
+.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); }
@@ -132,7 +148,7 @@ code, .mono { font-family: var(--mono); font-size: 0.92em; }
 .tune-acct-head { display: flex; align-items: center; gap: 8px; }
 .seg-btn[aria-pressed=true] { background: var(--active); color: var(--text); font-weight: var(--strong-weight); }
 .seg-btn:focus-visible { outline: var(--focus-outline); outline-offset: 1px; box-shadow: var(--focus-ring); }
-.acct-head { margin-bottom: 10px; }
+.acct-head { margin-bottom: 10px; justify-content: flex-start; column-gap: 14px; }
 .acct-head h2 { display: flex; align-items: baseline; gap: 10px; }
 #acct-count { font-weight: 400; }
 
@@ -151,26 +167,38 @@ code, .mono { font-family: var(--mono); font-size: 0.92em; }
 .group-meta { margin-left: auto; display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
 .group-quota { display: inline-flex; align-items: center; gap: 8px; flex-wrap: wrap; justify-content: flex-end; }
 
-/* List rows: identity, one column per quota window, usage, last used, health, menu. Every column but the first has a
-   fixed width, so the rows of all groups line up under the same column titles. --qn is the number of quota
-   columns; the page sets it on #accounts. */
-#accounts { --qn: 2; --q-w: 148px; --u-w: 168px; --l-w: 82px; --h-w: 112px; --m-w: 28px; --col-gap: 20px; }
-.row, .col-head { display: grid; grid-template-columns: minmax(0, 1fr) calc(var(--qn) * var(--q-w) + (var(--qn) - 1) * var(--col-gap)) var(--u-w) var(--l-w) var(--h-w) var(--m-w); column-gap: var(--col-gap); align-items: center; min-width: 0; }
-.row { grid-template-areas: "id quota usage last health more" "notes notes notes notes notes notes"; padding: 11px 10px 11px 16px; border-top: 1px solid var(--border); transition: background-color .12s; }
+/* List rows: identity, one column per quota window, last used, menu; a click opens the details (model, tokens,
+   Health) under them. Every column but the first has a fixed width, so the rows of all groups line up under the
+   same column titles. --qn is the number of quota columns; the page sets it on #accounts. */
+#accounts { --qn: 2; --q-w: 176px; --l-w: 92px; --m-w: 28px; --col-gap: 28px; }
+.row, .col-head { display: grid; grid-template-columns: minmax(0, 1fr) calc(var(--qn) * var(--q-w) + (var(--qn) - 1) * var(--col-gap)) var(--l-w) var(--m-w); column-gap: var(--col-gap); align-items: center; min-width: 0; }
+.row { grid-template-areas: "id quota last more" "detail detail detail detail" "notes notes notes notes"; padding: 11px 10px 11px 16px; border-top: 1px solid var(--border); transition: background-color .12s; }
 .rows .row:hover { background: color-mix(in srgb, var(--hover) 55%, transparent); }
 .row:first-child { border-top: 0; }
 .row:last-child { border-radius: 0 0 var(--radius) var(--radius); }
 .row-error .ident-name .name { color: var(--fail); }
-/* One account folded to its name line, opened again with the arrow at its start. */
+/* A login group (spec §3.21): the head carries the email and the one quota; the directories sit indented under it. */
+.login { border-top: 1px solid var(--border); }
+.login:first-child { border-top: 0; }
+.rows .login > .login-head { border-top: 0; padding-bottom: 4px; }
+.rows .login > .login-head:hover { background: transparent; }
+.login-rows > .row, .login-rows > .row:first-child { border-top: 1px dashed var(--border); padding-left: 40px; }
+.login-rows > .row:last-child { border-radius: 0 0 var(--radius) var(--radius); }
+/* The arrow at a row's start opens and closes its details; so does a click anywhere else in the row. */
 .row-toggle { width: 28px; height: 28px; margin: -4px -6px -4px -8px; }
 .fold-hit { cursor: pointer; }
-.row > .ident.fold-hit { align-self: stretch; margin: -11px 0 -11px -16px; padding: 11px 0 11px 16px; }
 .fold-hit:hover .row-toggle { background: var(--hover); color: var(--text); }
 .row-toggle[aria-expanded=true] .chev { transform: rotate(90deg); }
 .row-toggle[aria-expanded=true]:not(:hover) { background: transparent; color: var(--muted); }
 .fold-hit:hover .row-toggle[aria-expanded=true] { background: var(--hover); color: var(--text); }
-.row-folded { grid-template-areas: "id id id id id more"; padding-top: 7px; padding-bottom: 7px; }
-.card-folded .card-head { align-items: center; }
+/* The details: ref and model, tokens, Health, side by side under the name. */
+.row-detail { grid-area: detail; display: flex; flex-wrap: wrap; gap: 10px 36px; margin: 10px 0 2px 64px; padding-top: 10px; border-top: 1px dashed var(--border); cursor: default; }
+.rd-item { display: flex; flex-direction: column; gap: 4px; min-width: 0; }
+.rd-label { color: var(--faint); font-size: 11.5px; font-weight: var(--strong-weight); }
+.rd-note { color: var(--muted); font-size: 12px; }
+.rows .row-detail .usage { justify-content: flex-start; gap: 16px; }
+.row-detail .ident-sub { margin-top: 0; }
+.att-dot { flex: none; }
 .col-head { position: sticky; top: 0; z-index: 2; padding: 7px 10px 7px 16px; border-top: 1px solid var(--border); background: var(--surface); color: var(--faint); font-size: 11.5px; font-weight: var(--strong-weight); line-height: 1.3; white-space: nowrap; }
 .col-head > span { min-width: 0; overflow: hidden; text-overflow: ellipsis; }
 .col-head .quota > span { overflow: hidden; text-overflow: ellipsis; }
@@ -184,18 +212,27 @@ code, .mono { font-family: var(--mono); font-size: 0.92em; }
 .model-btn:focus-visible { outline: var(--focus-outline); outline-offset: 2px; }
 .model-set { color: var(--accent); }
 .md-now { display: flex; flex-direction: column; gap: 4px; }
+.br-list { list-style: none; margin: 0 0 12px; padding: 0; display: flex; flex-direction: column; gap: 6px; }
+.br-row { display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 6px 10px; border: 1px solid var(--border); border-radius: var(--ctl-radius); }
 .email-btn:hover { color: var(--text); text-decoration: underline dotted; }
 .email-btn:focus-visible { outline: var(--focus-outline); outline-offset: 2px; }
+.ident-email:has(.br-btn) { display: flex; align-items: center; }
+.ident-email:has(.br-btn) > * { flex: none; }
+.ident-email:has(.br-btn) > .email-btn:not(.br-btn) { flex: 0 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; }
+.br-btn { display: inline-flex; align-items: center; gap: 3px; vertical-align: bottom; }
+.br-ico { width: 12px; height: 12px; flex: none; }
 .ident-email + .ident-sub { color: var(--faint); margin-top: 0; }
 .tools .tb-icon { width: var(--ctl-h); height: var(--ctl-h); border-color: var(--border-strong); background: var(--surface); }
 .tools .tb-icon:hover { background: var(--hover); }
 .tools .tb-icon[aria-pressed=true] { background: var(--active); color: var(--text); }
+.display-panel { display: flex; flex-direction: column; gap: 10px; min-width: 240px; }
+.dp-row { display: flex; align-items: center; justify-content: space-between; gap: 16px; }
+.dp-label { color: var(--muted); font-size: var(--small); }
+.dp-check { justify-content: flex-start; gap: 8px; cursor: pointer; font-size: var(--small); }
 .ident-sub { color: var(--muted); font-size: 12px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; margin-top: 1px; }
 .plan { text-transform: capitalize; }
 .row > .quota { grid-area: quota; }
-.row > .usage { grid-area: usage; }
 .row > .last { grid-area: last; }
-.cell-health { grid-area: health; min-width: 0; }
 .row > .more { grid-area: more; }
 .row-notes { grid-area: notes; display: flex; flex-direction: column; gap: 6px; margin-top: 8px; }
 
@@ -339,7 +376,6 @@ a.btn:hover { text-decoration: none; }
 .icon-btn:disabled { color: var(--faint); cursor: not-allowed; }
 .top-actions .icon-btn { width: var(--ctl-h); height: var(--ctl-h); border-color: var(--border-strong); background: var(--surface); }
 .top-actions .icon-btn:hover { background: var(--hover); }
-.lang-btn { font-size: 12.5px; font-weight: var(--button-weight); color: var(--btn-text); width: auto !important; padding: 0 10px; }
 .btn:focus-visible, .icon-btn:focus-visible, input:focus-visible, select:focus-visible, a:focus-visible, .stat-btn:focus-visible { outline: var(--focus-outline); outline-offset: 2px; box-shadow: var(--focus-ring); }
 .btn:focus-visible { border-color: var(--focus); }
 .note a, .banner a { color: inherit; text-decoration: underline; text-underline-offset: 2px; font-weight: var(--strong-weight); }
@@ -349,6 +385,9 @@ a.btn:hover { text-decoration: none; }
 .note b { color: inherit; }
 .note-fail { background: var(--fail-soft); color: var(--fail); }
 .note-warn { background: var(--warn-soft); color: var(--warn); }
+/* A note in two lines: what is wrong, then the command to run (with its copy button and the install page). */
+.note-line { flex-basis: 100%; min-width: 0; overflow-wrap: anywhere; }
+.note-cmd { display: flex; flex-wrap: wrap; align-items: center; gap: 6px 12px; }
 .error-note { justify-content: space-between; gap: 12px; }
 .error-note > span { min-width: 0; overflow-wrap: anywhere; }
 .error-note > .note-sub { flex-basis: 100%; color: var(--text); }
@@ -358,6 +397,9 @@ a.btn:hover { text-decoration: none; }
 .banner-fail { background: var(--fail-soft); border-color: transparent; color: var(--fail); }
 .banner-warn { background: var(--warn-soft); border-color: transparent; color: var(--warn); }
 .banner ul { margin: 6px 0 0; padding-left: 18px; }
+.rc-list { list-style: none; margin: 10px 0; padding: 0; display: grid; gap: 8px; }
+.rc-row { padding: 8px 10px; border: 1px solid var(--border); border-radius: 8px; display: grid; gap: 2px; }
+.rc-row code { word-break: break-all; }
 .banner-actions { display: flex; gap: 8px; flex: none; }
 .hp-how { margin: 0; padding-left: 20px; display: flex; flex-direction: column; gap: 4px; }
 .hp-steps { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 8px; }
@@ -490,6 +532,18 @@ select:is(:hover, :focus) { --chevron: var(--text); }
 /* The hint gives way first: it shrinks to an ellipsis so a long label never pushes it past the menu's edge. */
 .menu-hint { min-width: 0; margin-left: auto; padding-left: 12px; color: var(--faint); font-size: 11px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
 .menu-sep { height: 1px; margin: 4px 6px; background: var(--border); }
+/* Popover: the menu's floating box with free content (text, a few buttons), lighter than a dialog. */
+.popover { width: 280px; padding: 12px 14px; display: flex; flex-direction: column; gap: 8px; }
+.popover p { margin: 0; }
+.popover-actions { display: flex; gap: 8px; flex-wrap: wrap; }
+.popover-foot { padding-top: 8px; border-top: 1px solid var(--border); }
+/* The header's settings popover: two segmented choices, then links to Remote Control and Auto Handoff. */
+.set-row { display: flex; align-items: center; justify-content: space-between; gap: 12px; }
+.set-label { color: var(--muted); font-size: 13px; white-space: nowrap; }
+.set-row .seg { height: var(--ctl-h-sm); }
+.set-link { margin: 0 -8px; width: calc(100% + 16px); }
+.set-link .chip { margin-left: auto; }
+.set-dot { background: var(--warn-bar); }
 .tip { display: inline-flex; position: relative; vertical-align: middle; }
 .tip-btn { display: inline-grid; place-items: center; width: 16px; height: 16px; padding: 0; border: 1px solid var(--border-strong); border-radius: 50%; background: var(--surface); color: var(--muted); font: 700 10px/1 var(--font); cursor: help; }
 .tip-btn:hover, .tip.is-open .tip-btn { color: var(--text); border-color: var(--muted); }
@@ -543,8 +597,9 @@ select:is(:hover, :focus) { --chevron: var(--text); }
   .col-head { display: none; }
   .app-row { flex-wrap: wrap; }
   .app-actions { width: 100%; justify-content: flex-start; }
-  .row { grid-template-columns: minmax(0, 1fr) auto var(--m-w); grid-template-areas: "id health more" "quota quota quota" "usage usage last" "notes notes notes"; row-gap: 10px; }
-  .row-folded { grid-template-areas: "id id more"; }
+  .row { grid-template-columns: minmax(0, 1fr) auto var(--m-w); grid-template-areas: "id last more" "quota quota quota" "detail detail detail" "notes notes notes"; row-gap: 10px; }
+  .row-detail { margin-left: 0; }
+  .login-rows > .row, .login-rows > .row:first-child { padding-left: 28px; }
   .row > .quota { grid-template-columns: repeat(var(--qn), minmax(0, 1fr)); max-width: 560px; }
   .rows .m-label, .rows .m-unit, .rows .u-unit { display: inline; }
   .rows .usage { justify-content: flex-start; }
@@ -559,12 +614,12 @@ 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; }
   .brand .logo { width: 34px; height: 34px; }
   .brand h1 { font-size: 19px; }
-  #updated { display: none; }
   .banner { flex-direction: column; }
   .stat { padding: 11px 13px; align-items: flex-start; flex-direction: column; gap: 6px; }
   .stat-value { font-size: 19px; }

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

@@ -1,5 +1,8 @@
+import type { LocalBuild } from '../core/version.ts';
 import { pageStyles } from './page-styles.ts';
 import { type ResolvedTheme } from './theme.ts';
+/** Browsers keep a favicon past `no-cache`; a link that changes with the mark makes them fetch the new one. */
+export declare const FAVICON_VERSION: string;
 export { pageStyles };
 export interface PageOptions {
     basePath: string;
@@ -9,6 +12,8 @@ export interface PageOptions {
     version?: string;
     /** buildId() of the serving process; the page reloads when /api/state reports another one. */
     build?: string;
+    /** localBuild() of the serving process (ADR-0024): the version pill names the commit. */
+    local?: LocalBuild | null;
     readOnly?: boolean;
     /** Host theme from resolveTheme(); the default look when absent. */
     theme?: ResolvedTheme;

package/dist/src/panel/page.js

@@ -1,13 +1,16 @@
 // The Panel page: one self-contained HTML document with inline CSS and JS, no external resources. The parts live in
 // sibling modules: page-styles.ts (tokens and CSS), page-script.ts (behaviour, with page-logic.ts helpers) and
 // i18n.ts (English and Chinese text); this module assembles them under the CSP nonce.
-import { MARK_SVG } from '../core/brand-mark.js';
+import { createHash } from 'node:crypto';
+import { FAVICON_SVG, MARK_SVG } from '../core/brand-mark.js';
 import { ALIAS_NAME, RESERVED_ALIASES } from '../core/config.js';
 import { QUOTA_FAIL_PERCENT, QUOTA_WARN_PERCENT, USAGE_DAYS } from '../core/quota-levels.js';
 import { MESSAGES } from './i18n.js';
 import { PAGE_SCRIPT } from './page-script.js';
 import { pageStyles } from './page-styles.js';
 import { resolveTheme } from './theme.js';
+/** Browsers keep a favicon past `no-cache`; a link that changes with the mark makes them fetch the new one. */
+export const FAVICON_VERSION = createHash('sha256').update(FAVICON_SVG).digest('hex').slice(0, 10);
 export { pageStyles };
 /** JSON that is safe inside a `<script>` element: no `</script>`, `<!--` or line separators survive. */
 export function jsonForScript(value) {
@@ -33,6 +36,7 @@ export function renderPage(opts) {
         token: opts.token,
         version: opts.version ?? '',
         build: opts.build ?? '',
+        local: opts.local ?? null,
         readOnly: Boolean(opts.readOnly),
         updates: opts.updates !== false,
         colorScheme: theme.colorScheme,
@@ -52,7 +56,7 @@ export function renderPage(opts) {
 <meta name="color-scheme" content="${scheme}">
 <meta name="referrer" content="no-referrer">
 <title>sideby</title>
-<link rel="icon" type="image/svg+xml" href="${attr(opts.basePath)}/favicon.svg">
+<link rel="icon" type="image/svg+xml" href="${attr(opts.basePath)}/favicon.svg?v=${FAVICON_VERSION}">
 <style${nonce}>${pageStyles(theme)}</style>
 </head>
 <body${theme.header === 'bar' ? ' class="header-bar"' : ''}>
@@ -61,16 +65,13 @@ 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" aria-haspopup="dialog" aria-expanded="false" hidden></button></div>
         <p class="tagline" data-i18n="top.tagline">Every AI coding account, side by side.</p>
       </div>
     </div>
     <div class="top-actions">
-      <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="settings" class="btn" type="button" aria-haspopup="dialog" aria-expanded="false"${lang === 'auto' ? '' : ' hidden'}><span data-i18n="set.button">Settings</span></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>
   </div>
@@ -82,7 +83,7 @@ export function renderPage(opts) {
   <section id="handoff-page" class="block" aria-labelledby="h-handoff" hidden></section>
   <section id="tuning-page" class="block" aria-labelledby="h-tuning" hidden></section>
   <section id="accounts-page" class="block" aria-labelledby="h-accounts">
-    <div class="section-head acct-head"><h2 id="h-accounts"><span data-i18n="acct.title">Accounts</span><span id="acct-count" class="muted small"></span></h2></div>
+    <div class="section-head acct-head"><h2 id="h-accounts"><span data-i18n="acct.title">Accounts</span><span id="acct-count" class="muted small"></span></h2><span id="updated" class="muted small" role="status">Loading…</span></div>
     <div id="toolbar" class="toolbar" hidden></div>
     <div id="accounts" aria-busy="true"><div class="group group-list">${SKELETON_ROW.repeat(4)}</div></div>
   </section>
@@ -90,7 +91,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"><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>
+  <footer class="foot muted small"><button id="ver" class="link-btn" type="button" aria-haspopup="dialog" aria-expanded="false">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/src/runtime.d.ts

@@ -59,7 +59,10 @@ export interface FamilyInfo {
     title: string;
     bin: string;
     installUrl: string;
+    installCommand?: string;
     installed: boolean;
+    /** A `bin` on PATH that exists but cannot run (an interrupted upgrade); set only when `installed` is false. */
+    brokenBin?: string;
     /** Plugin that provides the Family. */
     plugin: string;
     /** The Family can estimate a Compaction Threshold (spec §3.18). */
@@ -232,7 +235,9 @@ export interface Runtime {
     remoteControl(): Promise<RemoteControlGroup[]>;
     /** Sets `remoteControlAtStartup` to false wherever it is on or left to the default, remembering how to undo it. */
     remoteControlOff(): Promise<RemoteControlChange>;
-    /** Puts back what `remoteControlOff` replaced, only where the key still holds false. */
+    /** Sets `remoteControlAtStartup` to true wherever it is off or left to the default, remembering how to undo it. */
+    remoteControlOn(): Promise<RemoteControlChange>;
+    /** Puts back what `remoteControlOff` or `remoteControlOn` replaced, only where the key still holds what it wrote. */
     remoteControlUndo(): Promise<RemoteControlChange>;
     /**
      * Which Account of a Family to move on to (spec §3.13). Throws a UserError with code `no-quota-source`

package/dist/src/runtime.js

@@ -10,10 +10,10 @@ import { handoffFindings } from './core/handoff-doctor.js';
 import { selectNext } from './core/handoff-select.js';
 import { identityOf } from './core/identity.js';
 import { mergeDoctorHistory, readDoctorHistory, writeDoctorHistory, } from './core/last-doctor.js';
-import { prepareLaunch, which } from './core/launch.js';
+import { brokenOnPath, prepareLaunch, which } from './core/launch.js';
 import { memoStore } from './core/memo-store.js';
 import { resolvePaths } from './core/paths.js';
-import { remoteControlGroups, turnRemoteControlOff, undoRemoteControlOff, } from './core/remote-control.js';
+import { remoteControlGroups, turnRemoteControlOff, turnRemoteControlOn, undoRemoteControlOff, } from './core/remote-control.js';
 import { findResumeRoute } from './core/resume.js';
 import { SAME_LOGIN_FAMILIES, sameLoginGroups, sharedQuota } from './core/same-login.js';
 import { shareMeaning } from './core/share-meaning.js';
@@ -205,15 +205,23 @@ export async function createRuntime(opts = {}) {
         plugins: loaded.plugins,
         pluginErrors: loaded.errors,
         async familyInfo() {
-            return Promise.all([...families.values()].map(async (f) => ({
-                id: f.id,
-                title: f.title,
-                bin: f.bin,
-                installUrl: f.installUrl,
-                installed: (await which(f.bin, env)) !== null,
-                plugin: loaded.familyOwner.get(f.id) ?? 'unknown',
-                tuning: Boolean(f.readTuning),
-            })));
+            return Promise.all([...families.values()].map(async (f) => {
+                const installed = (await which(f.bin, env)) !== null;
+                const broken = installed ? null : await brokenOnPath(f.bin, env);
+                return {
+                    id: f.id,
+                    title: f.title,
+                    bin: f.bin,
+                    installUrl: f.installUrl,
+                    ...(typeof f.installCommand === 'string' && f.installCommand.trim()
+                        ? { installCommand: f.installCommand.trim() }
+                        : {}),
+                    installed,
+                    ...(broken ? { brokenBin: broken } : {}),
+                    plugin: loaded.familyOwner.get(f.id) ?? 'unknown',
+                    tuning: Boolean(f.readTuning),
+                };
+            }));
         },
         async familyDetails() {
             const info = new Map((await rt.familyInfo()).map((f) => [f.id, f]));
@@ -581,6 +589,9 @@ export async function createRuntime(opts = {}) {
         async remoteControlOff() {
             return turnRemoteControlOff(await accounts(), readContext());
         },
+        async remoteControlOn() {
+            return turnRemoteControlOn(await accounts(), readContext());
+        },
         async remoteControlUndo() {
             return undoRemoteControlOff(await accounts(), readContext());
         },

package/dist/src/types.d.ts

@@ -42,6 +42,8 @@ export interface FamilyDef {
     /** Host executable looked up on PATH. */
     bin: string;
     installUrl: string;
+    /** The Host's official one-line install command, shown before `installUrl`; sideby never runs it. */
+    installCommand?: string;
     /** Environment variable that selects the Account directory. Not set for the Main Account. */
     selectVar: string;
     layout: FamilyLayout;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sideby",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "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)",
@@ -55,13 +55,15 @@
   ],
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json && chmod +x dist/src/cli/main.js && node scripts/write-build-id.ts",
+    "local": "node scripts/local.ts",
     "typecheck": "tsc --noEmit",
     "lint": "biome check .",
     "format": "biome check --write .",
-    "test": "node --test --test-concurrency=4 \"src/**/*.test.ts\" \"testing/**/*.test.ts\"",
+    "test": "node --test --test-concurrency=4 \"src/**/*.test.ts\" \"testing/**/*.test.ts\" \"scripts/**/*.test.ts\"",
     "schemas": "node src/cli/schemas.ts",
     "leak-check": "sh scripts/leak-check.sh",
     "check": "pnpm typecheck && pnpm lint && pnpm test && pnpm leak-check",
+    "preversion": "node scripts/readme-assets.ts",
     "version": "node scripts/sync-skill-version.ts && git add skills/sideby/SKILL.md",
     "prepublishOnly": "node scripts/pin-english-npm-readme.ts",
     "postpublish": "node scripts/pin-english-npm-readme.ts --restore"
@@ -77,5 +79,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 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"
+  "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| Choose whether Claude sessions connect to claude.ai by themselves (Remote Control), for every account at once | `sideby remote-control off` or `on` (or the panel's Settings) | [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/browser-open.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "sideby/browser-open.json",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "ref",
+    "url",
+    "profile",
+    "command"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "ref": {
+      "type": "string"
+    },
+    "url": {
+      "type": "string"
+    },
+    "profile": {
+      "type": "object",
+      "required": [
+        "dir",
+        "name"
+      ],
+      "properties": {
+        "dir": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        }
+      }
+    },
+    "command": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "The `open` command sideby ran."
+    }
+  },
+  "title": "sideby browser open --json"
+}

package/schemas/browser-switch.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "sideby/browser-switch.json",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "enabled",
+    "changed",
+    "applied",
+    "file",
+    "reads"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "enabled": {
+      "type": "boolean",
+      "description": "The value asked for."
+    },
+    "changed": {
+      "type": "boolean"
+    },
+    "applied": {
+      "type": "boolean",
+      "description": "False when only the change was shown; run again with --yes (exit 10)."
+    },
+    "file": {
+      "type": "string",
+      "description": "The config file."
+    },
+    "reads": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "What sideby reads while it is on, all on this computer."
+    }
+  },
+  "title": "sideby browser --enable|--disable --json"
+}