sideby 0.3.0 → 0.4.0

package/schemas/tune-change.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "sideby/tune-change.json",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "account",
+    "action",
+    "applied"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "account": {
+      "type": "string"
+    },
+    "action": {
+      "anyOf": [
+        {
+          "type": "string",
+          "const": "apply"
+        },
+        {
+          "type": "string",
+          "const": "undo"
+        }
+      ]
+    },
+    "applied": {
+      "type": "boolean",
+      "description": "True once the change was written (or undone)."
+    },
+    "plan": {
+      "type": "object",
+      "required": [
+        "status",
+        "file",
+        "link",
+        "affected",
+        "current",
+        "next",
+        "creates"
+      ],
+      "properties": {
+        "status": {
+          "anyOf": [
+            {
+              "type": "string",
+              "const": "ready"
+            },
+            {
+              "type": "string",
+              "const": "unchanged"
+            },
+            {
+              "type": "string",
+              "const": "blocked"
+            }
+          ]
+        },
+        "file": {
+          "type": "string"
+        },
+        "link": {
+          "type": "boolean"
+        },
+        "affected": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "current": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "next": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "creates": {
+          "type": "boolean"
+        },
+        "reason": {
+          "type": "string"
+        }
+      }
+    },
+    "message": {
+      "type": "string"
+    }
+  },
+  "title": "sideby tune apply|undo --json"
+}

package/schemas/tune.json

@@ -0,0 +1,243 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "sideby/tune.json",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "accounts"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "accounts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "ref",
+          "family",
+          "tuning"
+        ],
+        "properties": {
+          "ref": {
+            "type": "string"
+          },
+          "family": {
+            "type": "string"
+          },
+          "tuning": {
+            "anyOf": [
+              {
+                "type": "object",
+                "required": [
+                  "status",
+                  "days",
+                  "estimate",
+                  "models"
+                ],
+                "properties": {
+                  "status": {
+                    "type": "string",
+                    "const": "ok"
+                  },
+                  "days": {
+                    "type": "number"
+                  },
+                  "estimate": {
+                    "type": "boolean",
+                    "const": true
+                  },
+                  "models": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "required": [
+                        "model",
+                        "calls",
+                        "contextWindow",
+                        "configured",
+                        "effective",
+                        "compactions",
+                        "suggestion",
+                        "reason"
+                      ],
+                      "properties": {
+                        "model": {
+                          "type": "string"
+                        },
+                        "calls": {
+                          "type": "number"
+                        },
+                        "contextWindow": {
+                          "type": "number"
+                        },
+                        "configured": {
+                          "anyOf": [
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Configured threshold in tokens; null is the Host default."
+                        },
+                        "effective": {
+                          "anyOf": [
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "compactions": {
+                          "type": "object",
+                          "required": [
+                            "total",
+                            "auto",
+                            "manual",
+                            "preTokensP50",
+                            "preTokensMax"
+                          ],
+                          "properties": {
+                            "total": {
+                              "type": "number",
+                              "description": "All compactions, including those whose trigger the Host does not record."
+                            },
+                            "auto": {
+                              "type": "number"
+                            },
+                            "manual": {
+                              "type": "number"
+                            },
+                            "preTokensP50": {
+                              "anyOf": [
+                                {
+                                  "type": "number"
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ]
+                            },
+                            "preTokensMax": {
+                              "anyOf": [
+                                {
+                                  "type": "number"
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ]
+                            }
+                          }
+                        },
+                        "suggestion": {
+                          "anyOf": [
+                            {
+                              "type": "object",
+                              "required": [
+                                "threshold",
+                                "savedPercent",
+                                "savedWeighted"
+                              ],
+                              "properties": {
+                                "threshold": {
+                                  "type": "number"
+                                },
+                                "savedPercent": {
+                                  "anyOf": [
+                                    {
+                                      "type": "number"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
+                                "savedWeighted": {
+                                  "anyOf": [
+                                    {
+                                      "type": "number"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                }
+                              }
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "The estimated cheapest threshold; null when `reason` says why there is none."
+                        },
+                        "reason": {
+                          "anyOf": [
+                            {
+                              "type": "string",
+                              "const": "suggested"
+                            },
+                            {
+                              "type": "string",
+                              "const": "already-best"
+                            },
+                            {
+                              "type": "string",
+                              "const": "insufficient-calls"
+                            },
+                            {
+                              "type": "string",
+                              "const": "no-compactions"
+                            },
+                            {
+                              "type": "string",
+                              "const": "no-optimum"
+                            },
+                            {
+                              "type": "string",
+                              "const": "unknown-model"
+                            },
+                            {
+                              "type": "string",
+                              "const": "observe-only"
+                            }
+                          ]
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              {
+                "type": "object",
+                "required": [
+                  "status",
+                  "reason"
+                ],
+                "properties": {
+                  "status": {
+                    "type": "string",
+                    "const": "unavailable"
+                  },
+                  "reason": {
+                    "type": "string"
+                  },
+                  "detail": {
+                    "type": "string"
+                  }
+                }
+              }
+            ]
+          }
+        }
+      }
+    }
+  },
+  "title": "sideby tune --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, 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.
 metadata:
-  version: "0.3.0"
+  version: "0.4.0"
   requires:
     bins: [sideby, node]
   cliHelp: sideby --help
@@ -20,7 +20,7 @@ Do every step you can yourself. Only browser sign-in, secrets and interactive se
 - **Never sign in for the user.** Give them `sideby login <ref>` as one line to run in their own terminal (Claude Code: `! sideby login <ref>`). OAuth needs their browser and their decision.
 - **Never put a secret on the command line or in chat.** For API accounts, the user edits `proxy.env` themselves.
 - **Never start a Host session from your shell.** `sideby run`, `sideby next` (without `--dry-run`) and `sideby login` open an interactive session; give the user the command instead.
-- **Never switch, rotate or proxy accounts.** sideby does not do it, and you must not work around that by editing config, copying session files or moving credentials. Choosing the next account is the user's call; `sideby next` only recommends.
+- **Never switch, rotate or proxy accounts yourself.** Do not work around sideby by editing config, copying session files or moving credentials. `sideby next` only recommends. Moving a running task on its own is Auto Handoff, which the user turns on: use `sideby handoff enable` (exit 10, then their yes), never hand-edit `config.json`. Inside such a session you may run `sideby handoff ready` when the user asks to hand over.
 - **Say what you change.** Read-only commands first. What the user asked for (the account they asked to create, its short command, the shell line that makes it work) you do, saying what you do. Changes they did not ask for (`doctor --fix` on other accounts, `quota setup`, `app install`) wait until they have seen the change and agreed.
 - Do not edit Host config files (`settings.json`, `config.toml`, symlinks in account directories) by hand when a `sideby` command does the job.
 
@@ -42,7 +42,9 @@ Account refs are `<family>:<name>`; a bare `<name>` works only when it is unique
 | See accounts, health, quota and usage | `sideby list --json`, `sideby doctor --json`, `sideby quota --json` | `references/diagnose.md` |
 | Repair drift or permissions | `sideby doctor [ref] --json`, then `--fix` after they agree | `references/diagnose.md` |
 | Keep working because an account hit its limit | `sideby next <family> --json` | `references/handoff.md` |
+| Turn on Auto Handoff ("自动交接", "hand over when quota runs low"), see what it still needs, hand this session over now, or pick an account with room for a subtask | `sideby handoff status --json`, `sideby handoff enable --json` (exit 10 first), `sideby handoff ready`, `sideby next <family> --json` | `references/handoff.md` |
 | Create an account with a given name, an API account, or a short command | `sideby new`, `sideby alias add` | `references/accounts.md` |
+| Tune the auto-compact threshold ("which compaction setting costs the fewest tokens"), use the suggestion or undo it | `sideby tune --json`, `sideby tune apply` (exit 10 first), `sideby tune undo` | `references/diagnose.md` |
 | See Claude quota (it shows `not-enabled`) | `sideby quota setup claude` (exits 10) | `references/quota.md` |
 | See everything at once | `sideby ui` (local panel on `127.0.0.1:17420`; `--no-open` prints the address) | — |
 | Start an account | give them `sideby run <ref> [-- host args]` | — |
@@ -53,7 +55,7 @@ Read only the reference the task needs.
 
 `eval "$(sideby shell-init zsh)"` defines one function per account (`sideby-claude-work`) plus the config `aliases`. Users who source a file instead set config `shellInitFile` (for example `{ "zsh": "~/.config/sideby/shell-init.zsh" }`); `new` and `alias add|rm` keep it current, and `sideby shell-init zsh --write` rewrites it. New functions work in a new shell.
 
-When a terminal manager such as Orca reopens a pane with a bare `claude --resume <id>` (or `codex resume <id>`, `grok --resume <id>`) and the Host says `No conversation found`, the session lives in another account. Suggest config `"resumeRouting": true` followed by `sideby shell-init --write` (or a new shell with `eval`): `shell-init` then defines Host-named functions that call `sideby resume <family>`, which starts the account holding that session. For a one-off, find it with `ls -d ~/.claude*/projects/*/<id>.jsonl` and run `sideby run <ref> -- --resume <id>`.
+When a terminal manager such as Orca reopens a pane with a bare `claude --resume <id>` (or `codex resume <id>`, `grok --resume <id>`) and the Host says `No conversation found`, the session lives in another account. Suggest config `"resumeRouting": true` followed by `sideby shell-init --write` (or a new shell with `eval`): `shell-init` then defines Host-named functions that call `sideby resume <family>`, which starts the account holding that session. For a one-off, find it with `ls -d ~/.claude*/projects/*/<id>.jsonl` and run `sideby run <ref> -- --resume <id>`. When no account has that file, the session was opened but never got a message, so there is nothing to resume: `ls -d ~/.claude*/session-env/<id>` names the account that started it, and with routing on `sideby resume` starts a new session there by itself.
 
 For someone who would rather double-click than use a terminal, `sideby app install` adds a desktop 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.
 

package/skills/sideby/references/badge.md

@@ -22,7 +22,7 @@ For "show the account in the status line", "加上 [cc001] 这个标识". sideby
 
    Never add a second `[ui]` table; if `[ui.status_line]` exists, change it.
 3. `sideby doctor grok --fix` copies `config.toml` to subscription accounts (it must be a real copy there). API accounts (`kind: "api"`) keep their own `config.toml`: add the same table to each.
-4. `GROK_HOME=<dir> grok inspect` must not report the new keys as unrecognized. It takes effect in a new Grok session.
+4. `GROK_HOME=<dir> grok inspect` must not report the new keys as unrecognized. It takes effect in a new Grok session, and Grok hides the row on its welcome screen: tell the user it appears after the first message.
 
 ## Codex: terminal tab title
 

package/skills/sideby/references/diagnose.md

@@ -45,3 +45,7 @@ Quota is only as fresh as each account's last session; `observedAt` says when it
 `--fix` never replaces a real file with a link, never re-points an existing symlink (wrong or dangling links are only reported), never writes through a link into the Main Account, and never changes credential contents. Findings it skips need a human decision; explain the hint, do not work around it with `rm` or `ln`.
 
 `doctor` exits 1 only when a `fail` finding is left; warnings alone exit 0.
+
+## Context tuning
+
+`sideby tune [ref|family] --json` estimates, per model, the auto-compact threshold that spends the fewest tokens, from the account's last 7 days of local sessions. It is read-only and an estimate: each model has `reason` (`suggested` carries `suggestion.threshold`; the others say why there is none: `insufficient-calls`, `no-compactions`, `no-optimum` (the cheapest point is at the bottom of the range tried, so there is no clear best), `unknown-model`, `already-best`, `observe-only`). Only Claude gets suggestions; Codex is observation only; Grok and pi return `no-source`. The analysis changes nothing. To use a suggestion run `sideby tune apply <ref> [tokens]`: it prints the file, the change and every account sharing that file (a linked `settings.json` is one shared file) and exits 10. Show that to the user in plain words, and only after a yes rerun with `--yes`. `sideby tune undo <ref> --yes` puts the old value back. Do not hand-edit `settings.json` for the user.

package/skills/sideby/references/handoff.md

@@ -1,6 +1,6 @@
 # Handoff: keep working on another account
 
-Use this when the user says an account hit its 5-hour or weekly limit ("usage limit reached", "rate limited", "resets at …") and wants to keep working, or asks which account has room. sideby recommends the account of the same family with the lowest Quota Pressure (the fullest window that has not reset yet). It never switches by itself; the user starts the next account.
+Use this when the user says an account hit its 5-hour or weekly limit ("usage limit reached", "rate limited", "resets at …") and wants to keep working, or asks which account has room. sideby recommends the account of the same family with the lowest Quota Pressure (the fullest window that has not reset yet), and the user starts it. Only Auto Handoff, which the user turns on in the config, moves a running task by itself (see below).
 
 ## Steps
 
@@ -35,7 +35,29 @@ Use this when the user says an account hit its 5-hour or weekly limit ("usage li
 - Host arguments the user wants (another model, say) go after `--`: `sideby next claude -- --model opus`.
 - Quota is only as fresh as each account's last session. Do not promise an account has room; say what the data shows and when it was recorded.
 
+## Auto Handoff (the user turns it on)
+
+With config `"handoff": { "auto": true }`, a session sideby started hands its task to the next account when quota runs low; see the guide's Auto Handoff section for the settings. If you are in such a session (the environment has `SIDEBY_HANDOFF_RUN`):
+
+- When sideby tells you the quota is at 80%, write the handoff brief at the path it names and keep it current: the goal, what is done, the remaining steps, key decisions and why, the files that matter. Reference specs, ADRs, commits and diffs by path; list the skills the next agent should use; never include keys, passwords or personal data.
+- When it says the quota is at 95%, finish the current step, update the brief, and end your turn. sideby starts the next account from it.
+- When the user asks to hand over now, update the brief, run `sideby handoff ready` (add `--brief <file>` when the user's own handoff tool wrote one), and end your turn.
+
+### Turning it on for the user
+
+1. Run `sideby handoff status --json`. Read `auto`, `sideby` (is the `sideby` on PATH able to run the hook), each family's `starts`, `ready`, `problems` and `notes`, and `nextSteps`.
+2. Tell the user what Auto Handoff does, that it is off by default, and the risk: hand-over between two subscriptions of one vendor (`--same-family`, cc001 → cc002) is the kind vendors may act on. Add `--same-family` only when the user asks for it. Ask which accounts each family should hand over to if they care about the order (`--order claude=codex001,cc002`; accounts or short commands, any family).
+3. Run `sideby handoff enable [flags] --json`. Exit 10 means the config change was shown: show the user `diff`, ask, and only after a clear yes run the same command with `--yes`. It writes only the `handoff` key of the config and returns `nextSteps`.
+4. Work through `nextSteps` in order. `sideby quota setup claude` and `sideby handoff setup grok` also exit 10 first: ask before adding `--yes`. `npm i -g sideby` installs or upgrades sideby on PATH; ask first. Codex needs the user to trust sideby's hooks once per account (`/hooks` in Codex); you cannot do that for them.
+5. Run `sideby handoff status --json` again and report which families are `ready`.
+
+To turn it off: `sideby handoff disable --json`, then `--yes` after the user agrees; the other settings stay. The panel has the same settings under **Auto Handoff** in its top bar.
+
+## Picking an account for a subtask
+
+Before you delegate work to another account (for example a review in a headless run), run `sideby next <family> --json` and use its `pick`, so the subtask lands on the account with the most room. Prefer an account of the same family for speed; running two subscriptions of one vendor at once carries the same vendor risk as `sameFamily`, so say so. A headless run such as `sideby run <pick> -- -p "<task>"` is yours to start only when the user asked for the delegation.
+
 ## Never
 
 - Switch accounts by editing config or environment, copy session files between account directories, or read any credential.
-- Start a session for the user.
+- Start an interactive session for the user.

package/README.zh-CN.md

@@ -1,112 +0,0 @@
-<p align="center">
-  <img alt="sideby：一份共享配置，每个账号一个终端" src="https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/banner.jpg" width="880">
-</p>
-
-<p align="center">
-  <b>Run every AI coding account side by side.</b><br>
-  把 Claude Code、Codex、Grok Build、pi 的多个账号并排跑起来：每个账号一个目录，skills、hooks、规则共用一份，额度在一个面板里看完。
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/sideby"><img alt="npm" src="https://img.shields.io/npm/v/sideby"></a>
-  <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>
-  <img alt="Node 22.18+" src="https://img.shields.io/badge/node-%E2%89%A522.18-339933">
-  <a href="LICENSE"><img alt="MIT" src="https://img.shields.io/badge/license-MIT-blue"></a>
-</p>
-
-<p align="center"><a href="README.md">English</a> | 中文</p>
-
-## 为什么用 sideby
-
-你有一个工作订阅、一个个人订阅，可能还有一个 API key。切换类工具会改宿主的全局配置，同一时间只有一个账号生效；各账号的 skills 和 hooks 也会慢慢变得不一致。
-
-- **并排，不切换。** 每个账号一个独立目录，sideby 启动官方 CLI 时选中这个目录。三个账号可以同时开在三个终端里，你的 shell 环境不受影响。
-- **skills、hooks、规则只维护一份。** 主账号（例如 `~/.claude`）是唯一来源，其他账号链接或复制它的共享项（Shared Item，[共享了哪些](docs/guide/usage.zh-CN.md#每个账号共享什么)）。`sideby doctor --fix` 修复漂移，不碰真实文件，也不碰凭据。
-- **额度一屏看完。** 每个账号的 5 小时、7 天额度、重置时间和近 7 天 token 用量。额度用完了，`sideby next` 帮你启动剩余最多的账号。数据都来自本地文件：不联网，不读 token。
-
-## 快速上手
-
-需要 Node 22.18 或更高版本，并且至少装好一个宿主 CLI（Claude Code、Codex、Grok Build 或 pi）。AI agent 请改按 [`llms.txt`](llms.txt) 里 "Set up sideby for a user" 的步骤做。
-
-```sh
-npm i -g sideby
-sideby new claude work        # 新建 ~/.claude-work，共用 ~/.claude 的 skills 和 hooks
-sideby login claude:work      # 登录一次
-sideby run work               # 用 work 账号启动 Claude Code
-sideby ui                     # 在 http://127.0.0.1:17420 查看所有账号的额度
-```
-
-`sideby run claude:main` 可以同时在另一个终端里继续用 `~/.claude`。`--` 之后的参数原样交给宿主：`sideby run work -- --resume`。不想安装，可以先跑 `npx sideby` 试试。
-
-## 让 AI 帮你装
-
-把下面这段粘贴给 Claude Code、Codex 或其他 coding agent：
-
-```text
-帮我安装 sideby（npm 包 `sideby`）和它的 agent skill，再给我加一个 Claude Code 账号。
-按 https://raw.githubusercontent.com/Adonis0123/sideby/main/llms.txt 里 "Set up sideby for a user" 的步骤来。
-```
-
-agent 会检查 Node 和宿主 CLI，装好 sideby 和 skill，建账号，告诉你它和主账号共享什么，并让短命令生效。你只需要在浏览器里登录一次，agent 会把那一行命令给你。装好 skill 之后，简短的说法也行：「再加一个 Claude 账号，叫 cc008」「我的 Codex 账号共享了什么」「哪个账号还有额度」。
-
-## 长什么样
-
-<img alt="终端里的 sideby：列出账号、查看额度、推荐下一个账号、发现并修复漂移" src="https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/demo.gif" width="1320">
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/panel-dark.zh-CN.png">
-  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/panel.zh-CN.png">
-  <img alt="sideby 面板：每个账号的 5h、7d 额度，近 7 天 token 用量和健康状态" src="https://raw.githubusercontent.com/Adonis0123/sideby/main/docs/assets/panel.zh-CN.png" width="1280">
-</picture>
-
-## 还能做什么
-
-| 你想 | 命令 | 说明 |
-|---|---|---|
-| 加一个 API key 账号（DeepSeek、网关等） | `sideby new claude deepseek --api` | [API 账号](docs/guide/usage.zh-CN.md#api-账号) |
-| 找出并修复账号之间的配置漂移 | `sideby doctor --fix` | [体检](docs/guide/usage.zh-CN.md#体检doctor) |
-| 看 Claude 额度（Codex 不用设置） | `sideby quota setup claude --yes` | [Claude 额度](docs/guide/usage.zh-CN.md#claude-额度) |
-| 账号撞上限额时换一个接着用 | `sideby next claude` | [接力](docs/guide/usage.zh-CN.md#账号撞上限额时) |
-| 用 `ccw` 这样的短命令 | `sideby alias add ccw claude:work` | [Shell 函数](docs/guide/configuration.zh-CN.md#shell-函数) |
-| 在 Orca 这类工具里重开会话时，自动进到存有它的账号 | config 里写 `"resumeRouting": true` | [从其他工具恢复会话](docs/guide/configuration.zh-CN.md#从其他工具恢复会话) |
-| 从 Dock 或应用菜单打开面板 | `sideby app install` | [桌面应用](docs/guide/panel.zh-CN.md#桌面应用) |
-| 把面板嵌进自己的本地页面 | `createPanelHandler()` | [嵌入面板](docs/guide/panel.zh-CN.md#嵌入面板) |
-| 新增一个宿主，或加启动前检查 | 本地插件 | [插件](docs/guide/plugins.zh-CN.md) |
-
-## 支持的宿主
-
-| 宿主 | 账号目录 | 登录 | 额度 | 用量（7 天） |
-|---|---|---|---|---|
-| Claude Code | `~/.claude`、`~/.claude-<name>` | `claude auth login` | ✓ 需先 `quota setup claude` | ✓ |
-| Codex CLI | `~/.codex`、`~/.codex-<name>` | `codex login` | ✓ | ✓ |
-| Grok Build | `~/.grok`、`~/.grok-<name>` | `grok login` | 无公开来源 | 无公开来源 |
-| pi | `~/.pi/agent`、`~/.pi-<name>/agent` | 在 pi 里输入 `/login` | 无公开来源 | 无公开来源 |
-
-sideby 启动 `PATH` 上的官方程序，从不修改它。测试过的版本和各宿主的注意事项见[使用指南](docs/guide/usage.zh-CN.md#宿主说明)。
-
-## 安全边界
-
-- 不改宿主的全局配置来切换账号，也不会自己轮换账号。
-- 不读取、不打印、不发送任何凭据的值。数据不出本机：sideby 不调用任何远程服务。
-- `doctor --fix` 不替换真实文件，也不改链接的指向。
-
-细节和服务条款的问题见[常见问题](docs/guide/faq.zh-CN.md)。
-
-## 文档
-
-- [使用指南](docs/guide/usage.zh-CN.md)：账号、API 账号、体检、额度、接力、宿主说明
-- [命令](docs/guide/commands.zh-CN.md)：所有命令、退出码和 `--json`
-- [配置](docs/guide/configuration.zh-CN.md)：`config.json`、短命令、Shell 函数
-- [面板](docs/guide/panel.zh-CN.md)：面板、桌面应用、嵌入
-- [插件](docs/guide/plugins.zh-CN.md)：自己写家族或启动 hook
-- [常见问题](docs/guide/faq.zh-CN.md)：服务条款、数据位置、同类工具对比、卸载
-
-## 给 AI agent
-
-- [`llms.txt`](llms.txt)：安装步骤、命令、JSON 契约和插件 API 的索引。`sideby families --json` 给出每个宿主的账号共享什么。
-- [`skills/sideby/SKILL.md`](skills/sideby/SKILL.md)：一个 Agent Skill，用来查看、修复、新建账号，以及在额度用完时换账号。用 `npx skills add Adonis0123/sideby -g` 安装；装的版本和 sideby 不一致时，`sideby doctor` 会提醒。
-- [`AGENTS.md`](AGENTS.md)：给维护本仓库的 agent 的规则。
-
-## 许可证
-
-[MIT](LICENSE)