severally-mcp 2.3.1 → 2.4.2

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,57 @@ flowchart TB
 macOS、Linux、Windows（PowerShell またはコマンドプロンプト）のどれでも、次の 1 行で入れられます。
 
 ```bash
-npx -y severally-mcp@2.3.1 install
+npx -y severally-mcp@2.4.2 install
 ```
 
 インストーラは、`PATH` で見つかった CLI のそれぞれに severally を登録します。末尾に `--dry-run` を付けると、何も
-変えずに変更内容だけを表示します。終わったら、クライアントを再起動してください。動いているセッションは、新しい
-登録を読み直しません。
+変えずに変更内容だけを表示します。
 
-Claude Code のプラグインマーケットプレイスから入れる方法、クローンから入れる方法、登録の確かめ方、インストーラが
-変えるものは、[docs/install.ja.md](docs/install.ja.md) にあります。
+macOS と Linux の既定のインストールは、`npm install -g` で `severally-mcp` コマンドを `PATH` に置きます。要るのは
+Codex のプラグインだけです。npm がグローバルに入れられないとき（たとえば sudo が要る、npm のグローバルのフォルダが
+`PATH` に無い）は、インストーラが代わりに Codex を直接登録し、そう表示します。ほかに必要なことはありません。
+
+終わったら、クライアントを再起動してください。動いているセッションは、新しい登録を読み直しません。相談を始めずに
+設定を確かめるには、次を実行します。
+
+```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)
+にあります。
 
 ### コマンドライン
 
 ```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,12 +149,10 @@ 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` を実行すると、相談を始めずに、設定ファイル・この機械から使える相談相手・
-入っている写しの版・どのクライアントに登録されているかを表示します。
-
 ### 更新
 
 次の 1 行で、最新版に入れ替わります。バージョン番号を調べる必要はありません。
@@ -129,8 +162,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)にあります。
 
 ### アンインストール
@@ -303,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"` を渡します。その回の
@@ -349,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
@@ -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,56 @@ 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.2 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.
+would change without changing anything.
 
-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).
+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.
+
+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
 
 ```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,12 +150,10 @@ 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.
-
 ### Updating
 
 This line replaces your install with the latest version, with no version number to look up:
@@ -131,8 +163,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
@@ -310,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
@@ -354,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/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
 ```