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.
- package/CODE_OF_CONDUCT.md +83 -0
- package/CONFIG.md +13 -7
- package/README.ja.md +157 -77
- package/README.md +162 -81
- package/bin/severally-mcp.mjs +3 -0
- package/config.example.json +26 -0
- package/docs/how-it-works.ja.md +11 -3
- package/docs/how-it-works.md +12 -4
- package/docs/install.ja.md +25 -6
- package/docs/install.md +30 -7
- package/package.json +5 -3
- package/plugins/severally/.claude-plugin/plugin.json +1 -1
- package/plugins/severally/.codex-plugin/plugin.json +4 -2
- package/plugins/severally/.mcp.json +2 -1
- package/plugins/severally/dist/severally-mcp.mjs +29639 -28215
- package/plugins/severally/skills/_template/SKILL.md.tmpl +19 -23
- package/plugins/severally/skills/_template/reference.md.tmpl +22 -10
- package/plugins/severally/skills/antigravity/severally/SKILL.md +19 -23
- package/plugins/severally/skills/antigravity/severally/reference.md +22 -10
- package/plugins/severally/skills/claude/severally/SKILL.md +19 -23
- package/plugins/severally/skills/claude/severally/reference.md +22 -10
- package/plugins/severally/skills/codex/severally/SKILL.md +19 -23
- package/plugins/severally/skills/codex/severally/reference.md +22 -10
- package/plugins/severally/skills/opencode/severally/SKILL.md +19 -23
- package/plugins/severally/skills/opencode/severally/reference.md +22 -10
- package/scripts/init-config.mjs +1 -1
- package/scripts/install.mjs +124 -9
- package/src/adapters/antigravity-sandbox.mjs +5 -1
- package/src/adapters/codex.mjs +17 -6
- package/src/brief.mjs +38 -16
- package/src/consultants.mjs +31 -10
- package/src/expose-paths.mjs +68 -5
- package/src/jobs.mjs +294 -56
- package/src/policy.mjs +49 -11
- package/src/redact.mjs +20 -1
- package/src/run.mjs +38 -5
- package/src/schema.mjs +35 -12
- package/src/server.mjs +96 -120
- package/src/status.mjs +63 -0
- 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
|
|
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
|
-
|
|
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
|
|
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`)
|
|
98
|
-
|
|
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
|
|
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.
|
|
4
|
-
"description": "A plugin that
|
|
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": ">=
|
|
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.
|
|
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.
|
|
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": {
|