severally-mcp 2.4.0 → 2.5.0

package/CONFIG.md

@@ -78,6 +78,7 @@ A name is lower-case letters, digits, `.` and `-`, at most 64 characters; `all`
 | `effort` | string | `high` | Reasoning effort, translated per CLI: Codex `-c model_reasoning_effort=…`, Claude Code `--effort …`, OpenCode the model variant `provider/model#…`. A value the CLI or model does not support fails the consultation as `model_unavailable` (e.g. glm-5.2 has `high`/`max` only). For OpenCode, a model written with its own `#variant` keeps it, and one written with a bare trailing `#` (`opencode/nemotron-3-ultra-free#`) runs with no variant, for models that have none. Not allowed on an Antigravity consultant: agy takes the effort from the model name (`gemini-3.8-flash-low` / `-medium` / `-high`). |
 | `timeout_ms` | number, 1000–7200000 | `server.timeout_ms` | This consultant's own wall-clock budget, for the one that reliably needs longer or shorter than the rest. |
 | `max_budget_usd` | number, 0.05–20 | `10` | Claude Code consultants only: the spending cap for one consultation. |
+| `fallback_model` | string | – | A model on the same CLI to run instead when `model`'s account quota is used up (`usage_limit`). The consultation is run again once, inside the same time budget, and the answer says that the fallback gave it; `model` on the result is the fallback, and the switch is listed under `retries`. If the fallback fails too, that failure is reported. Must differ from `model`. |
 | `vendor` | string | from the model name | The lineage, for the same-lineage note on an answer. Read from the model name (`gpt` → openai, `claude` → anthropic, `gemini` → google, `glm` → zai, `deepseek` → deepseek, `nemotron` → nvidia); set it for a model the name does not place. |
 | `enabled` | boolean | `true` | Turns this one consultant off, leaving the others on its CLI. |
 | `note` | string | – | Why it is off, as for `clis`. |

package/README.ja.md

@@ -90,24 +90,52 @@ flowchart TB
 macOS、Linux、Windows（PowerShell またはコマンドプロンプト）のどれでも、次の 1 行で入れられます。
 
 ```bash
-npx -y severally-mcp@2.4.0 install
+npx -y severally-mcp@2.5.0 install
 ```
 
 インストーラは、`PATH` で見つかった CLI のそれぞれに severally を登録します。末尾に `--dry-run` を付けると、何も
-変えずに変更内容だけを表示します。終わったら、クライアントを再起動してください。動いているセッションは、新しい
-登録を読み直しません。
-
-Claude Code だけで使うなら、プラグインマーケットプレイスから入れることもできます。Claude Code で
-`/plugin marketplace add coz-a/severally`、続けて `/plugin install severally@severally` を実行し、Claude Code を
-再起動します。見つかった CLI すべてに登録できる上の 1 行が基本の方法です。詳しくは
-[docs/install.ja.md](docs/install.ja.md#claude-code-のプラグインマーケットプレイスから入れる) にあります。
+変えずに変更内容だけを表示します。
 
 macOS と Linux の既定のインストールは、`npm install -g` で `severally-mcp` コマンドを `PATH` に置きます。要るのは
 Codex のプラグインだけです。npm がグローバルに入れられないとき（たとえば sudo が要る、npm のグローバルのフォルダが
 `PATH` に無い）は、インストーラが代わりに Codex を直接登録し、そう表示します。ほかに必要なことはありません。
 
-Claude Code のプラグインマーケットプレイスから入れる方法、クローンから入れる方法、登録の確かめ方、インストーラが
-変えるものは、[docs/install.ja.md](docs/install.ja.md) にあります。
+終わったら、クライアントを再起動してください。動いているセッションは、新しい登録を読み直しません。相談を始めずに
+設定を確かめるには、次を実行します。
+
+```bash
+npx -y severally-mcp@latest status
+```
+
+設定ファイル・この機械から使える相談相手・入っている写しの版・どのクライアントに登録されているか・各 CLI に
+ログインしているかを表示します。ログインの確認は CLI 自身の状態確認コマンドを読むだけで、プロンプトは送りません。
+使用枠を使い切っていないかは確かめません。それは最初の相談で分かります。
+
+Codex と Claude Code がある機械での出力の一部を示します。
+
+```text
+config: ok
+
+consultants:
+  codex: codex, <model>  available
+  claude-code: claude-code, <model>  available
+
+clients:
+  Claude Code  registered (listed by the client)
+  Codex        registered (listed by the client)
+
+login (out of quota is not checked; the first consultation shows it):
+  codex        logged in
+  claude-code  logged in
+```
+
+ここまで済んだら、[使い方](#使い方)のようにエージェントに最初の相談を頼んでください。
+
+Claude Code だけで使うなら、プラグインマーケットプレイスから入れることもできます。Claude Code で
+`/plugin marketplace add coz-a/severally`、続けて `/plugin install severally@severally` を実行し、Claude Code を
+再起動します。見つかった CLI すべてに登録できる上の 1 行が基本の方法です。プラグインマーケットプレイスから入れる
+方法、クローンから入れる方法、登録の確かめ方、インストーラが変えるものは、[docs/install.ja.md](docs/install.ja.md)
+にあります。
 
 ### コマンドライン
 
@@ -125,11 +153,6 @@ npx -y severally-mcp@latest install [--dry-run] [--manual] [--force] [--skip-glo
 
 方式ごとに何が変わるかは [docs/install.ja.md](docs/install.ja.md#2-つのインストール方式) にあります。
 
-`npx -y severally-mcp@latest status` を実行すると、相談を始めずに、設定ファイル・この機械から使える相談相手・
-入っている写しの版・どのクライアントに登録されているか・各 CLI にログインしているかを表示します。ログインの確認は
-CLI 自身の状態確認コマンドを読むだけで、プロンプトは送りません。使用枠を使い切っていないかは確かめません。それは
-最初の相談で分かります。
-
 ### 更新
 
 次の 1 行で、最新版に入れ替わります。バージョン番号を調べる必要はありません。
@@ -313,13 +336,13 @@ API キーで呼び出すモデル（OpenRouter や、OpenAI 互換のほかの
 |---|---|---|---|---|---|
 | Codex | できる | パスで拒否（権限プロファイル）。`.env` のようなファイル名では拒否しない | ある。サンドボックスの中（コマンドは動くが、書き込みとネットワークはできない） | できない | できる（`network: "off"` のときを除く） |
 | Claude Code | できる（`Read` / `Glob` / `Grep`） | 拒否（権限の規則） | なし | できない | できる（`network: "off"` のときを除く） |
-| Antigravity | できる（`view_file`） | 拒否（ツールのフック） | なし | できない | できる（`network: "off"` のときを除く） |
+| Antigravity | できる（`view_file`・`read_file`） | 拒否（ツールのフック） | なし | できない | できる（`network: "off"` のときを除く） |
 | OpenCode | できる（`read` / `glob` / `grep`） | 拒否（権限の規則） | なし（Code Mode の `execute` は拒否） | できない | できる（`network: "off"` のときを除く） |
 
 どの相談相手も、渡したファイルの写しだけが入った専用の作業ディレクトリで始まり、サーバはあなたのリポジトリの
-場所を伝えません。それでも、あなたの
-ユーザーアカウントで読めるファイルは、表で「拒否」とした秘密のパスを除いて読めます。Codex はファイルの名前では
-拒否しないので、あなたのリポジトリにある `.env` は Codex から読めます。
+場所を伝えません。それでも、あなたのユーザーアカウントで読めるファイルは、表で「拒否」とした秘密のパスを除いて
+読めます。例外は、ファイルを渡した相談での Claude Code です。そのときは、渡したファイルの写ししか読めません。
+Codex はファイルの名前では拒否しないので、あなたのリポジトリにある `.env` は Codex から読めます。
 
 **ディスクを読めて Web も閲覧できる相談相手は、読んだ内容を URL に載せて外に持ち出せます**。開いたページに、
 そうするよう書かれていた場合などです。それを防ぎたいときは、エージェントが `network: "off"` を渡します。その回の
@@ -359,6 +382,8 @@ CLI ごとにどう守らせているかは [docs/how-it-works.ja.md](docs/how-i
 
 - `npm install` のあと `npm test` を実行します。テストは本物の代わりに用意した CLI を相手にオフラインで動き、
   実際の API は呼びません。
+- CI では `npm run lint`・`npm run typecheck`・`npm run format:check` も確かめています。プルリクエストを出す前に
+  実行してください。
 - ソースか Skill のテンプレートを変えたら、`npm run build` を実行してください。ビルド済みのサーバ
   （`plugins/severally/dist/`）と生成した Skill はコミットしてあり、古いままだと CI が失敗します。
 - `npm run live-check` と `npm run doctor` は、入っている CLI を相手に本物の相談を実行するので、実際の使用量がかかります。

package/README.md

@@ -16,7 +16,7 @@ A plugin that lets your AI agent ask other coding agents for independent opinion
 The consultants are Codex, Claude Code, Antigravity and OpenCode. When the agent gets stuck in an investigation, or faces two options that look equally good, it asks the
 consultants for their opinions. It checks the findings that come back itself, and carries on from what it found.
 For an important decision, such as a change that is hard to reverse, it consults before asking you to approve it,
-and asks you only about what is yours to decide. You can also ask yourself: "ask Codex".
+and asks you only about what is yours to decide. You can also ask for one yourself: "ask Codex".
 
 The plugin puts the question to several independent consultants, and returns each one's answer on its own
 instead of merging them into one, because a disagreement means something too. The agent checks why they disagree
@@ -92,24 +92,51 @@ routes and the real CLIs have been tried on Linux only.
 One line, on macOS, Linux and Windows (PowerShell or Command Prompt):
 
 ```bash
-npx -y severally-mcp@2.4.0 install
+npx -y severally-mcp@2.5.0 install
 ```
 
 The installer registers severally with each CLI it finds on `PATH`. Add `--dry-run` at the end to print what it
-would change without changing anything. Then restart the clients: a running session does not reload the new
-registration.
-
-If you use only Claude Code, you can install from its plugin marketplace instead: run `/plugin marketplace add coz-a/severally`
-and then `/plugin install severally@severally` in Claude Code, and restart it. The one line above is the main route,
-since it registers every CLI it finds. Details are in
-[docs/install.md](docs/install.md#from-the-claude-code-plugin-marketplace).
+would change without changing anything.
 
 On macOS and Linux, the default install also runs `npm install -g` to put a `severally-mcp` command on `PATH`, which
 only Codex's plugin needs. If npm cannot install it globally (for example it needs sudo, or npm's global folder is
 not on `PATH`), the installer registers Codex directly instead and says so. Nothing else is needed.
 
-Installing from the Claude Code plugin marketplace or from a clone, checking the registration, and what the
-installer changes are in [docs/install.md](docs/install.md).
+Then restart the clients: a running session does not reload the new registration. To check the setup without
+starting a consultation, run:
+
+```bash
+npx -y severally-mcp@latest status
+```
+
+It shows the config file, the consultants this machine can reach, the installed copies' versions, which clients
+have severally registered and whether each CLI is logged in. The login check reads the CLI's own status command and
+sends no prompt; running out of quota is not checked, and the first consultation shows it.
+
+Part of the output on a machine with Codex and Claude Code:
+
+```text
+config: ok
+
+consultants:
+  codex: codex, <model>  available
+  claude-code: claude-code, <model>  available
+
+clients:
+  Claude Code  registered (listed by the client)
+  Codex        registered (listed by the client)
+
+login (out of quota is not checked; the first consultation shows it):
+  codex        logged in
+  claude-code  logged in
+```
+
+Then ask your agent for a first consultation, as in [Usage](#usage).
+
+If you use only Claude Code, you can install from its plugin marketplace instead: run `/plugin marketplace add coz-a/severally`
+and then `/plugin install severally@severally` in Claude Code, and restart it. The one line above is the main route,
+since it registers every CLI it finds. Installing from the marketplace or from a clone, checking the registration,
+and what the installer changes are in [docs/install.md](docs/install.md).
 
 ### Command line
 
@@ -127,11 +154,6 @@ npx -y severally-mcp@latest install [--dry-run] [--manual] [--force] [--skip-glo
 
 What each mode changes is in [docs/install.md](docs/install.md#two-install-modes).
 
-`npx -y severally-mcp@latest status` shows what is set up without starting a consultation: the config file, the
-consultants this machine can reach, the installed copies' versions, which clients have severally registered and
-whether each CLI is logged in. The login check reads the CLI's own status command and sends no prompt; running out
-of quota is not checked, and the first consultation shows it.
-
 ### Updating
 
 This line replaces your install with the latest version, with no version number to look up:
@@ -320,11 +342,13 @@ history is never sent. No consultant can:
 |---|---|---|---|---|---|
 | Codex | yes | blocked by path (permission profile), not by file name such as `.env` | yes, in its sandbox (commands run, but cannot write or reach the network) | no | yes, unless `network: "off"` |
 | Claude Code | yes (`Read` / `Glob` / `Grep`) | blocked (permission rules) | none | no | yes, unless `network: "off"` |
-| Antigravity | yes (`view_file`) | blocked (tool hook) | none | no | yes, unless `network: "off"` |
+| Antigravity | yes (`view_file`, `read_file`) | blocked (tool hook) | none | no | yes, unless `network: "off"` |
 | OpenCode | yes (`read` / `glob` / `grep`) | blocked (permission rules) | none (its Code Mode `execute` is refused) | no | yes, unless `network: "off"` |
 
 Every consultant starts in a working directory of its own that holds only copies of the files you handed it, and
-the server does not tell it where your repository is. It can still read any file your user account can read, except the credential paths the table marks blocked.
+the server does not tell it where your repository is. It can still read any file your user account can read, except
+the credential paths the table marks blocked. The one exception is Claude Code in a consultation that exposes files:
+it can then read only those copies.
 Codex does not block by file name, so a `.env` in your repository is readable to it.
 
 **A consultant that can both read your disk and browse could carry what it read out in a URL**, for example if a
@@ -364,6 +388,8 @@ a large change, open an issue first so we can talk it over. Everyone taking part
 [Code of Conduct](CODE_OF_CONDUCT.md).
 
 - `npm install`, then `npm test`. The tests run offline against stand-in CLIs and make no real API calls.
+- CI also runs `npm run lint`, `npm run typecheck` and `npm run format:check`. Run them before you open a pull
+  request.
 - After changing the source or the Skill template, run `npm run build`. The built server in
   `plugins/severally/dist/` and the generated Skills are committed, and CI fails when they are out of date.
 - `npm run live-check` and `npm run doctor` run real consultations against the CLIs you have installed, and spend

package/config.example.json

@@ -17,7 +17,7 @@
     "opus": { "cli": "claude-code", "model": "claude-opus-5-5", "effort": "max", "max_budget_usd": 5, "timeout_ms": 900000 },
     "fable": { "cli": "claude-code", "model": "claude-fable-5-1" },
     "sol": { "cli": "codex", "model": "gpt-6.1-sol" },
-    "gemini": { "cli": "antigravity", "model": "gemini-4-argon-high" },
+    "gemini": { "cli": "antigravity", "model": "gemini-4-argon-high", "fallback_model": "gemini-3.8-flash-high" },
     "glm": { "cli": "opencode", "model": "zai-coding-plan/glm-5.3" },
     "deepseek": { "cli": "opencode", "model": "opencode/deepseek-v4.1-flash-free", "enabled": false, "note": "trial ended" },
     "nemotron": { "cli": "opencode", "model": "opencode/nemotron-3-ultra-free#", "vendor": "nvidia" }

package/docs/how-it-works.ja.md

@@ -37,6 +37,8 @@ OpenCode    ──(skill)──> severally server ──> codex exec | claude -p
 - 相談を始めても、主担当は相談している計画そのものは進めません。
 - 一時的な失敗（`rate_limited`、`cli_error`）は、少し待ってから、同じ時間の枠の中で、同じ相談相手とモデルで最大 2 回
   やり直します。それまでの失敗は `retries` に残ります。
+- 相談相手のモデルがアカウントの使用枠を使い切ったとき（`usage_limit`）は、設定に `fallback_model` があれば、その
+  モデルで 1 回だけやり直します。答えには代わりのモデルが答えたことが書かれ、`model` には実際に答えたモデルが入ります。
 - 時間切れになったときは、相談相手がそこまでに書いていた内容の末尾を、途中までのものという印を付けて失敗の隣に
   残します。これは読む材料として残すもので、答えとしては扱いません。
 - 相談の結果は、サーバを再起動したあとも、同じマシンで動くほかの severally のプロセスからも読めます。ほかのプロセスで

package/docs/how-it-works.md

@@ -38,6 +38,8 @@ OpenCode    ──(skill)──> severally server ──> codex exec | claude -p
 - While a consultation runs, the lead does not go ahead with the plan in question.
 - A transient failure (`rate_limited`, `cli_error`) is run again up to twice, after a short wait and inside the
   same time budget, with the same consultant and model; the earlier failures are listed under `retries`.
+- A consultant whose model has used up its account quota (`usage_limit`) is run again once on its `fallback_model`,
+  if the config names one. The answer says that the fallback gave it, and `model` shows the one that answered.
 - A consultant that runs out of time leaves the end of what it had written beside the failure, marked partial:
   something to read, not an answer.
 - A consultation stays readable after the server restarts, and from any other severally process on the machine.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "severally-mcp",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "A plugin that lets your AI agent ask other coding agents for independent opinions, returned separately.",
   "type": "module",
   "license": "Apache-2.0",
@@ -57,7 +57,9 @@
   "devDependencies": {
     "@eslint/js": "9.36.0",
     "@modelcontextprotocol/client": "^2.3.1",
+    "@types/cross-spawn": "6.0.6",
     "@types/node": "22.18.6",
+    "@types/which": "2.0.2",
     "esbuild": "^0.28.2",
     "eslint": "9.36.0",
     "globals": "16.4.0",

package/plugins/severally/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "severally",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Ask Codex, Claude Code, Antigravity or OpenCode for an independent opinion, review or structured debate, in a sandboxed child session that can read files and search the web but cannot edit files, change the system, or start other agents.",
   "author": {
     "name": "coz.a",

package/plugins/severally/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "severally",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Ask Codex, Claude Code, Antigravity or OpenCode for an independent opinion, review or structured debate, in a sandboxed child session that can read files and search the web but cannot edit files, change the system, or start other agents.",
   "author": {
     "name": "coz.a",