severally-mcp 2.3.1 → 2.4.0

package/README.ja.md

@@ -83,8 +83,6 @@ flowchart TB
 - Node.js 22 以降
 - インストールしてログインした CLI（4 つのうち少なくとも 1 つ）。1 つで足り、Claude Code だけでも、新しい
   Claude Code のセッションに相談できます。
-- macOS と Linux では、npm のグローバルの実行ディレクトリが `PATH` にあること。既定のインストールは、Codex が
-  起動する `severally-mcp` コマンドをそこに置きます。`--manual` なら要りません。
 
 インストーラとサーバは Linux・macOS・Windows でテストしています。Claude Code と Codex のマーケットプレイスからの
 導入と、実際の CLI での動作を試したのは Linux だけです。
@@ -92,20 +90,29 @@ flowchart TB
 macOS、Linux、Windows（PowerShell またはコマンドプロンプト）のどれでも、次の 1 行で入れられます。
 
 ```bash
-npx -y severally-mcp@2.3.1 install
+npx -y severally-mcp@2.4.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 install [--dry-run] [--manual] [--force] [--skip-global]
+npx -y severally-mcp@latest install [--dry-run] [--manual] [--force] [--skip-global] [--allow-local-tools]
 ```
 
 | オプション | すること |
@@ -114,11 +121,14 @@ npx -y severally-mcp@latest install [--dry-run] [--manual] [--force] [--skip-glo
 | `--manual` | プラグインを入れる代わりに、MCP サーバを登録して Skill を写す（Windows の既定） |
 | `--force` | すでに登録してあっても、そのままにせず登録し直す |
 | `--skip-global` | プラグイン方式で npm のグローバルなインストールを飛ばす。`PATH` 上の `severally-mcp` がすでにこのインストールを指しているときだけ使える |
+| `--allow-local-tools` | severally の手元で完結する 5 つのツールを、確認なしで Claude Code の許可リストに足す。`consult_start` は確認を残す |
 
 方式ごとに何が変わるかは [docs/install.ja.md](docs/install.ja.md#2-つのインストール方式) にあります。
 
 `npx -y severally-mcp@latest status` を実行すると、相談を始めずに、設定ファイル・この機械から使える相談相手・
-入っている写しの版・どのクライアントに登録されているかを表示します。
+入っている写しの版・どのクライアントに登録されているか・各 CLI にログインしているかを表示します。ログインの確認は
+CLI 自身の状態確認コマンドを読むだけで、プロンプトは送りません。使用枠を使い切っていないかは確かめません。それは
+最初の相談で分かります。
 
 ### 更新
 
@@ -129,8 +139,8 @@ npx -y severally-mcp@latest install
 ```
 
 `@latest` を付けると、npx は毎回 npm に最新版を問い合わせます。手元に古い写しがあっても、それは使いません。
-終わったら、クライアントを再起動してください。Claude Code のプラグインマーケットプレイスから入れた場合は、
-[docs/install.ja.md](docs/install.ja.md#更新) を見てください。版ごとの変更点は
+Claude Code にマーケットプレイス版の severally が入っていれば、同じ 1 行でその写しも更新されます（詳しくは
+[docs/install.ja.md](docs/install.ja.md#更新)）。終わったら、クライアントを再起動してください。版ごとの変更点は
 [リリース](https://github.com/coz-a/severally/releases)にあります。
 
 ### アンインストール

package/README.md

@@ -85,8 +85,6 @@ What a consultant can read and do is under [What a consultant can see and do](#w
 - Node.js 22 or newer
 - At least one of the four CLIs, installed and logged in. One is enough: with only Claude Code, you can still ask a
   fresh Claude Code session.
-- On macOS and Linux, npm's global executable directory on `PATH`: the default install puts a `severally-mcp`
-  command there for Codex to launch. `--manual` does without it.
 
 The installer and the server are tested on Linux, macOS and Windows; the Claude Code and Codex marketplace
 routes and the real CLIs have been tried on Linux only.
@@ -94,20 +92,29 @@ 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.3.1 install
+npx -y severally-mcp@2.4.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).
+
+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).
 
 ### Command line
 
 ```bash
-npx -y severally-mcp@latest install [--dry-run] [--manual] [--force] [--skip-global]
+npx -y severally-mcp@latest install [--dry-run] [--manual] [--force] [--skip-global] [--allow-local-tools]
 ```
 
 | Option | What it does |
@@ -116,11 +123,14 @@ npx -y severally-mcp@latest install [--dry-run] [--manual] [--force] [--skip-glo
 | `--manual` | registers the MCP server and copies the Skill instead of installing the plugin (the default on Windows) |
 | `--force` | registers again where severally is already registered, instead of leaving it as it is |
 | `--skip-global` | skips the global npm install in plugin mode, when `severally-mcp` on `PATH` is already this install |
+| `--allow-local-tools` | adds severally's five local tools to Claude Code's allow list without asking; `consult_start` still asks |
 
 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 and which clients have severally registered.
+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
 
@@ -131,8 +141,8 @@ npx -y severally-mcp@latest install
 ```
 
 With `@latest`, npx asks npm for the newest version every time, so an older copy it already has is not used.
-Then restart the clients. Installed from the Claude Code plugin marketplace: see
-[docs/install.md](docs/install.md#updating). What changed in each version is in the
+If Claude Code has severally from its plugin marketplace, the same line updates that copy too (details in
+[docs/install.md](docs/install.md#updating)). Then restart the clients. What changed in each version is in the
 [releases](https://github.com/coz-a/severally/releases).
 
 ### Uninstall

package/bin/severally-mcp.mjs

@@ -1,6 +1,15 @@
 #!/usr/bin/env node
 import fs from 'node:fs';
-import { main } from '../src/server.mjs';
+
+// Checked before anything else loads, so an older Node says what to do
+// instead of failing somewhere inside the server or the installer.
+const major = Number(process.versions.node.split('.')[0]);
+if (major < 22) {
+  process.stderr.write(
+    `severally: Node.js 22 or newer is needed (this is ${process.versions.node}); update Node.js and run it again\n`,
+  );
+  process.exit(1);
+}
 
 // `npx -y severally-mcp@latest install` runs the installer, so installing and
 // updating name the package once. Only the npm package has the installer
@@ -10,7 +19,9 @@ import { main } from '../src/server.mjs';
 if (process.argv[2] === 'install') {
   const installer = new URL('../scripts/install.mjs', import.meta.url);
   if (!fs.existsSync(installer)) {
-    process.stderr.write('severally: this is the installed server, not the installer; run: npx -y severally-mcp@latest install\n');
+    process.stderr.write(
+      'severally: this is the installed server, not the installer; run: npx -y severally-mcp@latest install\n',
+    );
     process.exit(1);
   }
   process.argv.splice(2, 1);
@@ -19,6 +30,7 @@ if (process.argv[2] === 'install') {
   const { status } = await import('../src/status.mjs');
   process.exitCode = status();
 } else {
+  const { main } = await import('../src/server.mjs');
   main().catch((err) => {
     process.stderr.write(`severally: fatal: ${err?.stack ?? err}\n`);
     process.exit(1);

package/docs/install.ja.md

@@ -12,8 +12,10 @@ npx はパッケージを自分のキャッシュに取ってきて、そこか
 
 README に書いた Node.js 22 以降とログイン済みの CLI のほかに、次の条件があります。
 
-- macOS / Linux では、npm のグローバルな実行ファイルのディレクトリが `PATH` に入っていること。既定のプラグイン方式
-  （下記）は、Codex が起動する `severally-mcp` コマンドをそこに入れます。`--manual` を付ければ不要です。
+- macOS / Linux では、npm のグローバルのフォルダについて必要なことはありません。既定のプラグイン方式（下記）は
+  `npm install -g` で、Codex のプラグインが起動する `severally-mcp` コマンドを `PATH` に置きます。npm がグローバルに
+  入れられないとき（たとえば sudo が要る、npm のグローバルのフォルダが `PATH` に無い）は、インストーラが代わりに
+  Codex を直接登録します。ほかに必要なことはありません。`--manual` を付ければ、このコマンドは要りません。
 - Windows では、PowerShell かコマンドプロンプトからネイティブに動きます。WSL は要りません。CLI は `PATH` と
   `PATHEXT` から探します（`.exe`、`.cmd`、`.bat`、空白を含むパスにも対応します）。
 
@@ -44,7 +46,11 @@ node scripts/install.mjs
 
 `npx -y severally-mcp@latest status` を実行すると、相談を始めずに、まとめて確かめられます。設定ファイルが正しいか、
 この機械から使える相談相手（使えないものはその理由）、入っている写しの版がそろっているか、どのクライアントに
-severally が登録されているかを表示します。CLI にログインしているかは確かめません。それは最初の相談で分かります。
+severally が登録されているか、各 CLI にログインしているかを表示します。ログインの確認は、各 CLI 自身の状態確認
+コマンドを読むだけで、プロンプトは送りません。Claude Code は `claude auth status`、Codex は `codex login status` です。
+OpenCode は `opencode auth list` で保存されている認証情報の数を見ます（環境変数のキーでも動くので、保存が無くても
+警告にとどめます）。Antigravity にはそうしたコマンドが無いので「not checked」と表示します。使用枠を使い切って
+いないかは確かめません。それは最初の相談で分かります。
 
 クライアントごとに自分で確かめるときは、再起動したあとに次を実行します。持っていない CLI の行は飛ばしてください。
 
@@ -76,7 +82,8 @@ Node.js 22 以降が `PATH` に入っている必要があります。ツール
 Codex、Antigravity、OpenCode からも使うなら、クローンしてインストーラも実行します（[クローンから入れる](#クローンから入れる)を参照）。
 インストーラはマーケットプレイス版を見つけると、Claude Code はそちらに任せます。マーケットプレイス版より先に
 インストーラを実行していた場合は、もう一度実行してください。そのままだと Claude Code が severally を二重に読み込みます。
-インストーラは、自分が以前に入れた Claude Code 用の写しと登録を、バックアップしてから取り除きます。
+インストーラは、自分が以前に入れた Claude Code 用の写しと登録を、バックアップしてから取り除きます。マーケットプレイス版が
+入ったあとは、同じインストーラの実行でそれも更新されます（[更新](#更新)を参照）。
 
 ## 2 つのインストール方式
 
@@ -95,9 +102,13 @@ Codex、Antigravity、OpenCode からも使うなら、クローンしてイン
 
 - サーバを依存パッケージごと `~/.severally/runtime/severally-mcp.mjs` に写します。どの登録も、クローンした
   フォルダではなく、この写しを指します。
-- プラグイン方式では、npm のグローバルなインストールも行います。これで、Codex が起動する `severally-mcp` コマンドが
-  入ります。`--skip-global` を付けるとこの手順を飛ばしますが、`PATH` 上の `severally-mcp` がすでに写した runtime を
-  指している場合しか受け付けません。手動方式ではグローバルなインストールは要りません。
+- macOS / Linux のプラグイン方式では、runtime を `severally-runtime` というパッケージ名で npm のグローバルにも入れます。
+  これで、Codex のプラグインが起動する `severally-mcp` コマンドが入ります。以前のインストールが残した `severally-mcp`
+  という名前のグローバルなパッケージは、先に `npm uninstall -g severally-mcp` で取り除きます。npm がコマンドを
+  グローバルに入れられないとき、または `PATH` の先頭にないときも、インストーラは止まらず、代わりに Codex を直接
+  登録して、そう表示します。登録は `--manual` と同じ `codex mcp add` で、長い `consult_get` の待ちも同じです。
+  `--skip-global` を付けるとグローバルなインストールを飛ばしますが、`PATH` 上の `severally-mcp` がすでに写した
+  runtime を指している場合しか受け付けません。手動方式ではグローバルなインストールは要りません。
 - クライアントの設定は、各 CLI のコマンド（`plugin add` / `mcp add`）だけで変えます。例外は手動で登録する Codex で、
   `config.toml` の `[mcp_servers.severally]` の表に `tool_timeout_sec = 660` の 1 行も書きます（Codex のプラグインと
   同じ長い待ちにするためで、`codex mcp add` では設定できません）。表にすでに `tool_timeout_sec` があれば、その値を
@@ -108,20 +119,28 @@ Codex、Antigravity、OpenCode からも使うなら、クローンしてイン
 - 方式を切り替えると、もう一方の方式で残った重複の登録を、バックアップしてから取り除きます。
 - Claude Code にマーケットプレイス版の severally がすでに入っていれば、Claude Code には登録しません。以前に
   インストーラが入れた Claude Code 用の写し（`~/.claude/skills/severally`）とユーザスコープの登録も取り除きます。
+  マーケットプレイス版の更新も行います（[更新](#更新)を参照）。
+- 最後に、Claude Code があり、`~/.claude/settings.json` が severally の手元で完結する 5 つのツールをまだ許可して
+  いなければ、足すかどうかを訊きます（次の節を参照）。このファイルのほかの部分は変えません。
 - Codex のマーケットプレイスのファイル `.agents/plugins/marketplace.json` は、このリポジトリから写します。
   公開されているマーケットプレイスは使いません。
 
 ## 外に何も送らないツールの許可の確認を省く
 
 `consult_start` 以外の 5 つのツールは手元で完結します。`consult_get`（相談が動いている間、繰り返し呼ぶ）、`consult_list`、
-`consult_cancel`、`consult_record`、`consult_export` です。どのクライアントにも許可リストに
-ツールを足すコマンドが無いので、インストーラは触りません。手で足してください。`consult_start` は確認を残します。
-ほかのベンダーに材料を送るのはこの呼び出しだからです。
+`consult_cancel`、`consult_record`、`consult_export` です。`consult_start` は確認を残します。ほかのベンダーに材料を
+送るのはこの呼び出しなので、インストーラも足しません。
 
 - **Claude Code**: Skill が、呼ばれたターンの間はこの 5 つを許可します（`allowed-tools`）。そのため相談のポーリングで
-  毎回は確認が出ません。代わりに Skill 自体の承認を 1 度求められます。後のターン（判定の記録や追加質問）でも省くには、
-  `~/.claude/settings.json` に書きます（プラグイン方式の場合。`--manual` では
-  `mcp__plugin_severally_severally__` を `mcp__severally__` に読み替えます）。
+  毎回は確認が出ません。代わりに Skill 自体の承認を 1 度求められます。後のターン（判定の記録や追加質問）でも省くために、
+  インストーラが足すかどうかを訊きます。インストールの最後に、Claude Code があり、`~/.claude/settings.json` が
+  この 5 つをまだ許可していなければ、端末で「Let Claude Code run ... without asking each time? [Y/n]」と訊きます
+  （既定は Y）。`--allow-local-tools` を付けると、訊かずに足します（スクリプトからのインストール向け）。端末が無く、
+  フラグも無いときは何も変えず、フラグを付けてやり直す方法を表示します。先に `settings.json` をバックアップし、
+  ほかの設定は残し、同じ規則を二重には足しません。規則の接頭辞は、プラグイン方式とマーケットプレイス版では
+  `mcp__plugin_severally_severally__`、手動方式では `mcp__severally__` です。手で足すときは、
+  `~/.claude/settings.json` に次を書きます（`--manual` では `mcp__plugin_severally_severally__` を
+  `mcp__severally__` に読み替えます）。
   ```json
   { "permissions": { "allow": [
     "mcp__plugin_severally_severally__consult_get", "mcp__plugin_severally_severally__consult_list",
@@ -139,6 +158,8 @@ Codex、Antigravity、OpenCode からも使うなら、クローンしてイン
 - **OpenCode** は、自分の `permission` の設定で変えていなければ、MCP ツールを確認なしで使います。
 - **Antigravity**: MCP ツールを 1 つずつ許可する規則の書き方を確かめていないので、ここでは扱いません。
 
+インストーラは、Codex・Antigravity・OpenCode の許可には触りません。
+
 ### 相談の開始の確認も省く
 
 エージェントは自分から相談します（相談するかどうかを訊かないよう Skill が指示しています）。そのため `consult_start` の
@@ -161,11 +182,15 @@ Claude Code なら許可リストに `mcp__plugin_severally_severally__consult_s
 クローンしたフォルダそのものを登録していた古いバージョンで入れた場合は、一度だけ `--force` を付けてください。既存の登録が、
 写した runtime を指すように切り替わります。付けなければ、既存の登録はそのまま残ります。
 
-マーケットプレイスから入れた場合は、Claude Code で `/plugin marketplace update severally` を実行してから再起動します。
+マーケットプレイスから入れた場合は、Claude Code にマーケットプレイス版の severally がすでに入っていれば、インストーラが
+`claude plugin marketplace update severally` と `claude plugin update severally@<マーケットプレイス名>` も実行します。
+そのため `npx -y severally-mcp@latest install` を 1 回実行すれば、すべての写しが同じバージョンになります。失敗したときは、
+Claude Code の中で実行するコマンド `/plugin marketplace update severally` を表示します。そのあと Claude Code を
+再起動してください。Claude Code だけなら、インストーラの代わりにこのコマンドを自分で実行しても構いません。
 自動の更新は既定では無効です。有効にするには、`/plugin` の Marketplaces で severally を選び、Enable auto-update を
-選びます。Codex、Antigravity、OpenCode からも使っている場合は、インストーラも実行し直してください。この 3 つは
-`~/.severally/runtime` にある別の写しを使い、どちらの写しも同じ `~/.severally/config.json` を読みます。設定の書き方が
-変わるリリースでは、両方を同じバージョンにそろえてください。`~/.severally/runtime` か `~/.claude/skills/severally` の
+選びます。Codex、Antigravity、OpenCode は `~/.severally/runtime` にある別の写しを使い、どちらの写しも同じ
+`~/.severally/config.json` を読みます。インストーラが両方を同じバージョンにそろえます。設定の書き方が変わる
+リリースでは、これが大事になります。`~/.severally/runtime` か `~/.claude/skills/severally` の
 写しが、答えているサーバと違うバージョンなら、`consult_start` の応答の `stale_install` がそれを知らせます。中身は、
 それぞれの写しのバージョンと、そろえるためのコマンドです。
 
@@ -190,7 +215,8 @@ Remove-Item -LiteralPath "$HOME/.codex/skills/severally" -Recurse -Force
 Remove-Item -LiteralPath "$HOME/.gemini/config/skills/severally" -Recurse -Force
 Remove-Item -LiteralPath "$HOME/.config/opencode/skills/severally" -Recurse -Force
 Remove-Item -LiteralPath "$HOME/.severally/runtime" -Recurse -Force
-# 以前にグローバルなコマンドを入れていた場合だけ:
+# 以前にグローバルなコマンドを入れていた場合だけ（古い名前は以前のインストール用）:
+npm.cmd uninstall -g severally-runtime
 npm.cmd uninstall -g severally-mcp
 ```
 
@@ -208,7 +234,8 @@ rm -rf ~/.gemini/config/skills/severally
 # "mcp" オブジェクトから "severally" の項目を手で消す）:
 #   ~/.config/opencode/opencode.json(c) を編集する
 rm -rf ~/.config/opencode/skills/severally
-npm uninstall -g severally-mcp
+npm uninstall -g severally-runtime
+npm uninstall -g severally-mcp    # 以前のインストールが残していた場合だけ
 rm -rf ~/.severally/runtime ~/.severally/marketplace
 ```
 
@@ -222,7 +249,8 @@ agy    mcp remove severally
 # "severally" の項目を手で消す
 rm -rf ~/.claude/skills/severally ~/.codex/skills/severally ~/.gemini/config/skills/severally \
        ~/.config/opencode/skills/severally
-# 以前にグローバルなコマンドを入れていた場合だけ:
+# 以前にグローバルなコマンドを入れていた場合だけ（古い名前は以前のインストール用）:
+npm uninstall -g severally-runtime
 npm uninstall -g severally-mcp
 rm -rf ~/.severally/runtime ~/.severally/marketplace
 ```

package/docs/install.md

@@ -12,8 +12,10 @@ into that cache, so it can be cleared afterwards.
 
 Beyond Node.js 22 or newer and a logged-in CLI, as in the README:
 
-- macOS/Linux: npm's global executable directory on `PATH`. The default (plugin mode, below) installs a
-  `severally-mcp` command there for Codex to launch. `--manual` does without it.
+- macOS/Linux: nothing about npm's global folder is required. The default (plugin mode, below) runs
+  `npm install -g` to put a `severally-mcp` command on `PATH` for Codex's plugin to launch. When 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 nothing else is needed. `--manual` does without the command.
 - Windows runs natively from PowerShell or Command Prompt; WSL is not required. CLIs are found through
   `PATH`/`PATHEXT` (`.exe`, `.cmd`, `.bat`, paths with spaces included).
 
@@ -44,8 +46,11 @@ run `npm run init-config` (see [Configuration](../README.md#configuration) in th
 
 `npx -y severally-mcp@latest status` shows it all at once, without starting a consultation: whether the config
 file is valid, which consultants this machine can reach (and why the others cannot), whether every installed copy
-is the same version, and which clients have severally registered. It does not check that a CLI is logged in; the
-first consultation shows that.
+is the same version, which clients have severally registered, and whether each CLI is logged in. The login check
+reads each CLI's own status command and sends no prompt: `claude auth status` for Claude Code, `codex login status`
+for Codex, and for OpenCode the number of credentials saved by `opencode auth list` (keys in the environment also
+work, so none saved is only a warning). Antigravity has no such command, so it shows "not checked". Running out of
+quota is not checked; the first consultation shows that.
 
 To check one client yourself, after restarting it. Skip the lines for CLIs you don't have:
 
@@ -77,7 +82,8 @@ route has been tried on Linux only.
 To use severally from Codex, Antigravity or OpenCode as well, also run the installer from a clone
 ([From a clone](#from-a-clone)). It finds the marketplace plugin and leaves Claude Code to it. If you ran the installer before
 adding the marketplace plugin, run it once more: Claude Code would otherwise load severally twice, and the
-installer removes its own Claude Code copy and registration, backing them up first.
+installer removes its own Claude Code copy and registration, backing them up first. Once the marketplace plugin is
+there, the same installer run also updates it (see [Updating](#updating)).
 
 ## Two install modes
 
@@ -96,9 +102,13 @@ Windows. Pass `--manual` to use manual mode on macOS/Linux too.
 
 - It copies the server, with its dependencies, to `~/.severally/runtime/severally-mcp.mjs`. Every registration
   points at that copy, not at the cloned folder.
-- In plugin mode it also runs a global npm install, which provides the `severally-mcp` command that Codex
-  launches. `--skip-global` skips that step and is accepted only when `severally-mcp` on `PATH` already points
-  at the copied runtime. Manual mode needs no global install.
+- In plugin mode on macOS/Linux it also runs a global npm install of the runtime under the package name
+  `severally-runtime`, which provides the `severally-mcp` command that Codex's plugin launches. A global package
+  named `severally-mcp` that an earlier install left is removed with `npm uninstall -g severally-mcp` first.
+  If npm cannot install the command globally, or it is not first on `PATH`, the installer does not stop: it
+  registers Codex directly, with the same `codex mcp add` registration and long `consult_get` wait as `--manual`,
+  and says so. `--skip-global` skips the global install and is accepted only when `severally-mcp` on `PATH` already
+  points at the copied runtime. Manual mode needs no global install.
 - It changes client settings only through each CLI's own commands (`plugin add` / `mcp add`), with one
   exception: for a manually registered Codex it also writes one line, `tool_timeout_sec = 660`, into
   `config.toml` under `[mcp_servers.severally]` (the same long wait the Codex plugin has; `codex mcp add` cannot
@@ -110,20 +120,29 @@ Windows. Pass `--manual` to use manual mode on macOS/Linux too.
   naming each backup after its original path.
 - Switching modes backs up and then removes the duplicate registration left by the other mode.
 - If Claude Code already has severally from the marketplace, the installer does not register it with Claude Code,
-  and removes its own earlier Claude Code copy (`~/.claude/skills/severally`) and user-scope registration.
+  and removes its own earlier Claude Code copy (`~/.claude/skills/severally`) and user-scope registration. It also
+  updates the marketplace copy (see [Updating](#updating)).
+- At the end, if Claude Code is present and `~/.claude/settings.json` does not yet allow severally's five local
+  tools, it offers to add them (see the next section). It changes nothing else in that file.
 - For Codex, the marketplace file `.agents/plugins/marketplace.json` is copied from this repository; no public
   listing is involved.
 
 ## Skipping the permission prompt for tools that send nothing out
 
 Every tool except `consult_start` stays on your machine: `consult_get` (called repeatedly while a
-consultation runs), `consult_list`, `consult_cancel`, `consult_record` and `consult_export`. None of the clients has a command that adds tools to its allowlist, so the installer
-leaves this to you. Keep `consult_start` prompting: it is the point where material leaves for another vendor.
+consultation runs), `consult_list`, `consult_cancel`, `consult_record` and `consult_export`. Keep `consult_start` prompting: it is the point where
+material leaves for another vendor, and the installer never adds it.
 
 - **Claude Code**: the Skill already allows these five tools (its `allowed-tools`) for the turn it is invoked in, so
   polling a consultation does not prompt each time; the Skill itself asks for approval once. For the later turns
-  (recording verdicts, a follow-up), add them in `~/.claude/settings.json` (plugin installs; for `--manual` write
-  `mcp__severally__` instead of `mcp__plugin_severally_severally__`):
+  (recording verdicts, a follow-up), the installer offers to add them. At the end of the install, if Claude Code is
+  present and `~/.claude/settings.json` does not yet allow the five tools, it asks at the terminal "Let Claude Code
+  run ... without asking each time? [Y/n]" (the default is yes). With `--allow-local-tools` it adds them without
+  asking, for scripted installs. Without a terminal and without the flag it changes nothing and prints how to rerun
+  with the flag. It backs up `settings.json` first, keeps every other setting, and never adds a rule twice. The
+  rules use the prefix `mcp__plugin_severally_severally__` in plugin mode or for a marketplace install, and
+  `mcp__severally__` in manual mode. To do it by hand, add this to `~/.claude/settings.json` (write
+  `mcp__severally__` instead of `mcp__plugin_severally_severally__` for `--manual`):
   ```json
   { "permissions": { "allow": [
     "mcp__plugin_severally_severally__consult_get", "mcp__plugin_severally_severally__consult_list",
@@ -141,6 +160,8 @@ leaves this to you. Keep `consult_start` prompting: it is the point where materi
 - **OpenCode** allows MCP tools without asking unless your own `permission` settings say otherwise.
 - **Antigravity**: not covered here; the rule syntax for a single MCP tool has not been checked.
 
+The installer does not touch the permissions of Codex, Antigravity or OpenCode.
+
 ### Letting consultations start without the prompt too
 
 The agent consults on its own (the Skill tells it not to ask whether to), so with `consult_start` prompting, every
@@ -164,11 +185,14 @@ and marketplace files under `~/.severally/backups/` before replacing them. Then
 Installed with an older version that registered the cloned folder itself? Add `--force` once to switch the
 existing registrations to the copied runtime. Without it, existing registrations are left as they are.
 
-Installed from the marketplace: run `/plugin marketplace update severally` in Claude Code, then restart it.
-Automatic updates are off by default; to turn them on, select severally under Marketplaces in `/plugin`, then
-Enable auto-update. If Codex, Antigravity or OpenCode use severally too, run the installer again as well: they
-run their own copy in `~/.severally/runtime`, and both copies read the same `~/.severally/config.json`, so keep
-them on the same version when a release changes the config format. When the copy in `~/.severally/runtime` or
+Installed from the marketplace: when Claude Code already has severally from the marketplace, the installer also
+runs `claude plugin marketplace update severally` and `claude plugin update severally@<marketplace>`, so one
+`npx -y severally-mcp@latest install` brings every copy to the same version. If that fails, it prints the command to
+run inside Claude Code, `/plugin marketplace update severally`. Restart Claude Code afterwards. For Claude Code
+alone you can also run that command yourself instead of the installer. Automatic updates are off by default; to
+turn them on, select severally under Marketplaces in `/plugin`, then Enable auto-update. Codex, Antigravity and
+OpenCode run their own copy in `~/.severally/runtime`, and both copies read the same `~/.severally/config.json`;
+the installer keeps them on the same version, which matters when a release changes the config format. When the copy in `~/.severally/runtime` or
 `~/.claude/skills/severally` runs a different version from the server answering, `consult_start` says so under
 `stale_install`, with the copies' versions and the commands that bring them level.
 
@@ -193,7 +217,8 @@ Remove-Item -LiteralPath "$HOME/.codex/skills/severally" -Recurse -Force
 Remove-Item -LiteralPath "$HOME/.gemini/config/skills/severally" -Recurse -Force
 Remove-Item -LiteralPath "$HOME/.config/opencode/skills/severally" -Recurse -Force
 Remove-Item -LiteralPath "$HOME/.severally/runtime" -Recurse -Force
-# Only if you previously installed the global command:
+# Only if you installed the global command earlier (the old name is for an earlier install):
+npm.cmd uninstall -g severally-runtime
 npm.cmd uninstall -g severally-mcp
 ```
 
@@ -213,7 +238,8 @@ rm -rf ~/.gemini/config/skills/severally
 # so delete the "severally" entry from the "mcp" object by hand):
 #   edit ~/.config/opencode/opencode.json(c)
 rm -rf ~/.config/opencode/skills/severally
-npm uninstall -g severally-mcp
+npm uninstall -g severally-runtime
+npm uninstall -g severally-mcp    # only if an earlier install left it
 rm -rf ~/.severally/runtime ~/.severally/marketplace
 ```
 
@@ -227,7 +253,8 @@ agy    mcp remove severally
 # ~/.config/opencode/opencode.json(c) by hand
 rm -rf ~/.claude/skills/severally ~/.codex/skills/severally ~/.gemini/config/skills/severally \
        ~/.config/opencode/skills/severally
-# Only if a global command was previously installed:
+# Only if a global command was installed earlier (the old name is for an earlier install):
+npm uninstall -g severally-runtime
 npm uninstall -g severally-mcp
 rm -rf ~/.severally/runtime ~/.severally/marketplace
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "severally-mcp",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "A plugin that lets your AI agent ask other coding agents for independent opinions, returned separately.",
   "type": "module",
   "license": "Apache-2.0",
@@ -42,7 +42,11 @@
     "live-mcp-check": "node scripts/live-mcp-check.mjs",
     "build": "node scripts/build.mjs",
     "init-config": "node scripts/init-config.mjs",
-    "prepack": "node scripts/build.mjs"
+    "prepack": "node scripts/build.mjs",
+    "format": "prettier --write \"**/*.mjs\"",
+    "format:check": "prettier --check \"**/*.mjs\"",
+    "lint": "eslint .",
+    "typecheck": "tsc -p tsconfig.json"
   },
   "dependencies": {
     "@modelcontextprotocol/server": "^2.3.1",
@@ -51,7 +55,13 @@
     "zod": "^4.6.5"
   },
   "devDependencies": {
+    "@eslint/js": "9.36.0",
     "@modelcontextprotocol/client": "^2.3.1",
-    "esbuild": "^0.28.2"
+    "@types/node": "22.18.6",
+    "esbuild": "^0.28.2",
+    "eslint": "9.36.0",
+    "globals": "16.4.0",
+    "prettier": "3.6.2",
+    "typescript": "5.9.2"
   }
 }

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

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "severally",
-  "version": "2.3.1",
+  "version": "2.4.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.3.1",
+  "version": "2.4.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",