severally-mcp 2.0.0 → 2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/CODE_OF_CONDUCT.md +83 -0
  2. package/CONFIG.md +13 -7
  3. package/README.ja.md +157 -77
  4. package/README.md +162 -81
  5. package/bin/severally-mcp.mjs +3 -0
  6. package/config.example.json +26 -0
  7. package/docs/how-it-works.ja.md +11 -3
  8. package/docs/how-it-works.md +12 -4
  9. package/docs/install.ja.md +25 -6
  10. package/docs/install.md +30 -7
  11. package/package.json +5 -3
  12. package/plugins/severally/.claude-plugin/plugin.json +1 -1
  13. package/plugins/severally/.codex-plugin/plugin.json +4 -2
  14. package/plugins/severally/.mcp.json +2 -1
  15. package/plugins/severally/dist/severally-mcp.mjs +29639 -28215
  16. package/plugins/severally/skills/_template/SKILL.md.tmpl +19 -23
  17. package/plugins/severally/skills/_template/reference.md.tmpl +22 -10
  18. package/plugins/severally/skills/antigravity/severally/SKILL.md +19 -23
  19. package/plugins/severally/skills/antigravity/severally/reference.md +22 -10
  20. package/plugins/severally/skills/claude/severally/SKILL.md +19 -23
  21. package/plugins/severally/skills/claude/severally/reference.md +22 -10
  22. package/plugins/severally/skills/codex/severally/SKILL.md +19 -23
  23. package/plugins/severally/skills/codex/severally/reference.md +22 -10
  24. package/plugins/severally/skills/opencode/severally/SKILL.md +19 -23
  25. package/plugins/severally/skills/opencode/severally/reference.md +22 -10
  26. package/scripts/init-config.mjs +1 -1
  27. package/scripts/install.mjs +124 -9
  28. package/src/adapters/antigravity-sandbox.mjs +5 -1
  29. package/src/adapters/codex.mjs +17 -6
  30. package/src/brief.mjs +38 -16
  31. package/src/consultants.mjs +31 -10
  32. package/src/expose-paths.mjs +68 -5
  33. package/src/jobs.mjs +294 -56
  34. package/src/policy.mjs +49 -11
  35. package/src/redact.mjs +20 -1
  36. package/src/run.mjs +38 -5
  37. package/src/schema.mjs +35 -12
  38. package/src/server.mjs +96 -120
  39. package/src/status.mjs +63 -0
  40. package/src/store.mjs +44 -1
package/docs/install.md CHANGED
@@ -10,7 +10,7 @@ into that cache, so it can be cleared afterwards.
10
10
 
11
11
  ## Requirements
12
12
 
13
- Beyond Node.js 20.10 or newer and a logged-in CLI, as in the README:
13
+ Beyond Node.js 22 or newer and a logged-in CLI, as in the README:
14
14
 
15
15
  - macOS/Linux: npm's global executable directory on `PATH`. The default (plugin mode, below) installs a
16
16
  `severally-mcp` command there for Codex to launch. `--manual` does without it.
@@ -42,7 +42,12 @@ run `npm run init-config` (see [Configuration](../README.md#configuration) in th
42
42
 
43
43
  ## Checking the registration
44
44
 
45
- After restarting the clients, check that each one sees severally. Skip the lines for CLIs you don't have:
45
+ `npx -y severally-mcp@latest status` shows it all at once, without starting a consultation: whether the config
46
+ file is valid, which consultants this machine can reach (and why the others cannot), whether every installed copy
47
+ is the same version, and which clients have severally registered. It does not check that a CLI is logged in; the
48
+ first consultation shows that.
49
+
50
+ To check one client yourself, after restarting it. Skip the lines for CLIs you don't have:
46
51
 
47
52
  ```bash
48
53
  # macOS / Linux (plugin mode)
@@ -65,7 +70,7 @@ For Claude Code alone, no clone and no installer are needed. In Claude Code:
65
70
  /plugin install severally@severally
66
71
  ```
67
72
 
68
- Restart Claude Code and check with `claude plugin details severally`. Node.js 20.10 or newer must be on `PATH`,
73
+ Restart Claude Code and check with `claude plugin details severally`. Node.js 22 or newer must be on `PATH`,
69
74
  since the plugin starts its server with `node`. The tools appear as `mcp__plugin_severally_severally__*`. This
70
75
  route has been tried on Linux only.
71
76
 
@@ -94,8 +99,12 @@ Windows. Pass `--manual` to use manual mode on macOS/Linux too.
94
99
  - In plugin mode it also runs a global npm install, which provides the `severally-mcp` command that Codex
95
100
  launches. `--skip-global` skips that step and is accepted only when `severally-mcp` on `PATH` already points
96
101
  at the copied runtime. Manual mode needs no global install.
97
- - It changes client settings only through each CLI's own commands (`plugin add` / `mcp add`). Before it does
98
- anything, it backs up each client's settings file (`~/.claude.json`, `~/.codex/config.toml`,
102
+ - It changes client settings only through each CLI's own commands (`plugin add` / `mcp add`), with one
103
+ exception: for a manually registered Codex it also writes one line, `tool_timeout_sec = 660`, into
104
+ `config.toml` under `[mcp_servers.severally]` (the same long wait the Codex plugin has; `codex mcp add` cannot
105
+ set it). An existing `tool_timeout_sec` there is kept, and the wait follows it. If the line cannot be written,
106
+ Codex is registered without the long wait and the installer says so.
107
+ - Before it does anything, it backs up each client's settings file (`~/.claude.json`, `~/.codex/config.toml`,
99
108
  `~/.gemini/config/mcp_config.json` and `~/.gemini/antigravity-cli/settings.json`,
100
109
  `~/.config/opencode/opencode.json(c)`) and any existing Skill directory to `~/.severally/backups/<timestamp>/`,
101
110
  naming each backup after its original path.
@@ -107,8 +116,8 @@ Windows. Pass `--manual` to use manual mode on macOS/Linux too.
107
116
 
108
117
  ## Skipping the permission prompt for tools that send nothing out
109
118
 
110
- Every tool except `consult_start` stays on your machine: `consult_get` (called several times per
111
- consultation), `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
119
+ Every tool except `consult_start` stays on your machine: `consult_get` (called repeatedly while a
120
+ 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
112
121
  leaves this to you. Keep `consult_start` prompting: it is the point where material leaves for another vendor.
113
122
 
114
123
  - **Claude Code**: the Skill already allows these five tools (its `allowed-tools`) for the turn it is invoked in, so
@@ -132,6 +141,20 @@ leaves this to you. Keep `consult_start` prompting: it is the point where materi
132
141
  - **OpenCode** allows MCP tools without asking unless your own `permission` settings say otherwise.
133
142
  - **Antigravity**: not covered here; the rule syntax for a single MCP tool has not been checked.
134
143
 
144
+ ### Letting consultations start without the prompt too
145
+
146
+ The agent consults on its own (the Skill tells it not to ask whether to), so with `consult_start` prompting, every
147
+ consultation it starts waits for you once. That prompt is the only check before material leaves your machine, so it
148
+ stays by default. To drop it, add `consult_start` the same way as the tools above:
149
+ `mcp__plugin_severally_severally__consult_start` in Claude Code's allow list, or a
150
+ `[mcp_servers.severally.tools.consult_start]` table in Codex's `config.toml` (for a `--manual` registration; not
151
+ checked for the plugin install).
152
+
153
+ From then on, each consultation sends these to every consultant's model without asking you: the brief, the files
154
+ it exposes, and whatever the consultant reads while it runs (see
155
+ [What a consultant can see and do](../README.md#what-a-consultant-can-see-and-do)). Do it only where everything the
156
+ agent can reach may go to those vendors.
157
+
135
158
  ## Updating
136
159
 
137
160
  Run `npx -y severally-mcp@latest install`, or pull the clone and run `npm install` and
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "severally-mcp",
3
- "version": "2.0.0",
4
- "description": "A plugin that gives your AI agent consultants: Codex, Claude Code, Antigravity and OpenCode.",
3
+ "version": "2.3.1",
4
+ "description": "A plugin that lets your AI agent ask other coding agents for independent opinions, returned separately.",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
7
7
  "author": "coz.a (https://github.com/coz-a)",
@@ -27,10 +27,12 @@
27
27
  "README.md",
28
28
  "README.ja.md",
29
29
  "CONFIG.md",
30
+ "config.example.json",
31
+ "CODE_OF_CONDUCT.md",
30
32
  "docs"
31
33
  ],
32
34
  "engines": {
33
- "node": ">=20.10"
35
+ "node": ">=22"
34
36
  },
35
37
  "scripts": {
36
38
  "test": "node scripts/test.mjs",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
3
3
  "name": "severally",
4
- "version": "2.0.0",
4
+ "version": "2.3.1",
5
5
  "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.",
6
6
  "author": {
7
7
  "name": "coz.a",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "severally",
3
- "version": "2.0.0",
3
+ "version": "2.3.1",
4
4
  "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.",
5
5
  "author": {
6
6
  "name": "coz.a",
@@ -20,7 +20,9 @@
20
20
  "mcpServers": {
21
21
  "severally": {
22
22
  "type": "stdio",
23
- "command": "severally-mcp"
23
+ "command": "severally-mcp",
24
+ "env": { "SEVERALLY_MAX_WAIT_MS": "600000" },
25
+ "tool_timeout_sec": 660
24
26
  }
25
27
  },
26
28
  "interface": {
@@ -3,7 +3,8 @@
3
3
  "severally": {
4
4
  "type": "stdio",
5
5
  "command": "node",
6
- "args": ["${CLAUDE_PLUGIN_ROOT}/dist/severally-mcp.mjs"]
6
+ "args": ["${CLAUDE_PLUGIN_ROOT}/dist/severally-mcp.mjs"],
7
+ "env": { "SEVERALLY_MAX_WAIT_MS": "600000" }
7
8
  }
8
9
  }
9
10
  }