sideby 0.11.0 → 0.12.1

package/schemas/update.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "sideby/update.json",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "current",
+    "latest",
+    "available",
+    "method",
+    "command",
+    "canRun",
+    "releaseNotes",
+    "updated"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "current": {
+      "type": "string",
+      "description": "The running sideby version."
+    },
+    "latest": {
+      "type": "string",
+      "description": "The `latest` version on the npm registry."
+    },
+    "available": {
+      "type": "boolean",
+      "description": "`latest` is newer than `current`."
+    },
+    "method": {
+      "type": "object",
+      "required": [
+        "kind",
+        "canUpdate"
+      ],
+      "properties": {
+        "kind": {
+          "anyOf": [
+            {
+              "type": "string",
+              "const": "npm"
+            },
+            {
+              "type": "string",
+              "const": "pnpm"
+            },
+            {
+              "type": "string",
+              "const": "bun"
+            },
+            {
+              "type": "string",
+              "const": "volta"
+            },
+            {
+              "type": "string",
+              "const": "npx"
+            },
+            {
+              "type": "string",
+              "const": "project"
+            },
+            {
+              "type": "string",
+              "const": "source"
+            }
+          ],
+          "description": "How this copy was installed."
+        },
+        "canUpdate": {
+          "type": "boolean",
+          "description": "sideby can run the Update itself."
+        },
+        "reason": {
+          "type": "string",
+          "description": "Why it cannot."
+        }
+      }
+    },
+    "command": {
+      "type": "string",
+      "description": "What an Update runs, or what to run by hand when `canRun` is false."
+    },
+    "canRun": {
+      "type": "boolean"
+    },
+    "releaseNotes": {
+      "type": "string",
+      "description": "The release notes of `latest`."
+    },
+    "updated": {
+      "type": "boolean",
+      "description": "False when only the plan was shown (exit 10 with --yes still to add) or nothing to do."
+    },
+    "message": {
+      "type": "string"
+    },
+    "restartedPanel": {
+      "type": "boolean",
+      "description": "A background Panel was running and starts again with the new version."
+    },
+    "skill": {
+      "type": "string",
+      "description": "The command that updates the sideby skill; sideby never runs it."
+    },
+    "output": {
+      "type": "string",
+      "description": "What the failed install command printed."
+    }
+  },
+  "title": "sideby update --json"
+}

package/skills/sideby/SKILL.md

@@ -2,7 +2,7 @@
 name: sideby
 description: Use when the user runs, or wants to run, several AI coding accounts (Claude Code, Codex, Grok Build, pi) side by side. Covers installing sideby and setting up a new account ("install sideby", "set up another Claude account", "add cc008", "配置一个 cc00x", "再加一个 Codex 账号"), explaining what accounts share and what stays separate ("what do my accounts share?", "这些账号共享了什么"), showing which account a session is ("show [cc001] in the status line", "加上账号标识"), seeing accounts, quota and usage, moving on when one hits its 5-hour or weekly limit, moving the current task to another account ("用 cc008 继续", "交回 cc008"), adding a short command (alias), and repairing drifted account directories (skills, hooks, rules or settings not shared, wrong symlinks, credential file permissions). Drives the `sideby` CLI with `--json`; the agent does every step except browser sign-in, filling in secrets and starting interactive sessions, which it hands to the user as one command (inside an Auto Handoff session, `sideby handoff ready --to` moves the task itself).
 metadata:
-  version: "0.11.0"
+  version: "0.12.1"
   requires:
     bins: [sideby, node]
   cliHelp: sideby --help
@@ -65,6 +65,10 @@ Grok Bot is not a grok account's app: it signs in with a Cursor account, apart f
 
 For someone who would rather double-click than use a terminal, `sideby app install` adds a panel app (macOS `~/Applications/sideby.app`, Linux app menu) that runs `sideby ui --background`; `sideby ui --stop` stops it and `sideby app uninstall` removes the app. Ask before `app install`: it writes outside sideby's own directories.
 
+## Updating sideby
+
+To update sideby, run `sideby update --json` yourself: it shows `current`, `latest`, the `command` and whether sideby can run it (`canRun`; exit 10). Ask the user, then run `sideby update --yes --json`. When `canRun` is false (npx, a project dependency, a source checkout, a global folder they cannot write), hand them the `command` as one line instead. Updating restarts a background panel by itself; a `sideby ui` in a terminal and running sessions keep the old version until restarted. sideby checks the registry once a day on its own and turns that off with `NO_UPDATE_NOTIFIER=1` or config `"update": { "check": false }`; `"update": { "auto": true }` (off by default) installs new non-major versions by itself. Never turn Auto Update on without the user asking.
+
 ## Keeping this skill current
 
 If `sideby doctor --json` reports `skill.outdated`, this skill was written for another sideby version. Tell the user to update it with `npx skills add Adonis0123/sideby -g`.