@sandbaseai/cli 0.1.7 → 0.1.9
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/assets/mcp-bridge.mjs +116 -7
- package/dist/a1-adapters.d.ts +40 -0
- package/dist/a1-adapters.js +313 -0
- package/dist/adapters/index.d.ts +1 -0
- package/dist/adapters/index.js +68 -8
- package/dist/b-adapters.d.ts +35 -0
- package/dist/b-adapters.js +167 -0
- package/dist/c-adapters.d.ts +41 -0
- package/dist/c-adapters.js +269 -0
- package/dist/claude-desktop.d.ts +61 -0
- package/dist/claude-desktop.js +50 -0
- package/dist/cli.js +22 -5
- package/dist/clients.d.ts +1 -1
- package/dist/clients.js +53 -32
- package/dist/commands.d.ts +11 -3
- package/dist/commands.js +486 -20
- package/dist/cowork.d.ts +53 -0
- package/dist/cowork.js +46 -0
- package/dist/desktop-bridge.d.ts +28 -0
- package/dist/desktop-bridge.js +27 -0
- package/dist/kiro-ide.d.ts +26 -0
- package/dist/kiro-ide.js +100 -0
- package/dist/paths.js +28 -3
- package/dist/skills-cli.d.ts +41 -0
- package/dist/skills-cli.js +213 -7
- package/dist/skills.js +16 -5
- package/dist/types.d.ts +7 -1
- package/dist/types.js +5 -1
- package/dist/warp-adapter.d.ts +26 -0
- package/dist/warp-adapter.js +154 -0
- package/package.json +2 -1
package/dist/cli.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { connect, doctor, unregister } from "./commands.js";
|
|
3
3
|
import { clientList } from "./clients.js";
|
|
4
|
-
import { isClient } from "./types.js";
|
|
4
|
+
import { bridgeClients, isBridgeClient, isClient } from "./types.js";
|
|
5
5
|
if (Number(process.versions.node.split(".")[0]) < 20) {
|
|
6
6
|
console.error("SandBase CLI requires Node.js 20 or newer. Upgrade Node.js and retry.");
|
|
7
7
|
process.exit(1);
|
|
@@ -10,15 +10,28 @@ const [command, ...args] = process.argv.slice(2);
|
|
|
10
10
|
const at = args.indexOf("--client");
|
|
11
11
|
const value = at >= 0 ? args[at + 1] : undefined;
|
|
12
12
|
const client = value === undefined || value === "auto" ? "auto" : isClient(value) ? value : undefined;
|
|
13
|
-
|
|
13
|
+
const bridgeClient = value !== undefined && isBridgeClient(value) ? value : undefined;
|
|
14
|
+
if (command === "mcp-bridge") {
|
|
15
|
+
if (!bridgeClient || at !== 0 || args.length !== 2) {
|
|
16
|
+
console.error(`Usage: sandbase mcp-bridge --client <${bridgeClients.join("|")}>`);
|
|
17
|
+
process.exit(2);
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
else if (!command || !client || !["connect", "doctor", "unregister"].includes(command) || (at >= 0 && !value)) {
|
|
14
21
|
console.error(`Usage: sandbase <connect|doctor|unregister> [--client <${clientList()}|auto>]`);
|
|
15
22
|
process.exit(2);
|
|
16
23
|
}
|
|
17
24
|
const controller = new AbortController();
|
|
18
|
-
|
|
19
|
-
|
|
25
|
+
const signals = ["SIGINT", "SIGTERM"];
|
|
26
|
+
const abort = () => controller.abort();
|
|
27
|
+
for (const signal of signals)
|
|
28
|
+
process.once(signal, abort);
|
|
20
29
|
try {
|
|
21
|
-
if (command === "
|
|
30
|
+
if (command === "mcp-bridge") {
|
|
31
|
+
const runtime = await import(new URL("../assets/mcp-bridge.mjs", import.meta.url).href);
|
|
32
|
+
await runtime.runMCPBridge({ client: bridgeClient, signal: controller.signal });
|
|
33
|
+
}
|
|
34
|
+
else if (command === "connect")
|
|
22
35
|
await connect(client, { signal: controller.signal });
|
|
23
36
|
else if (command === "doctor") {
|
|
24
37
|
if (!(await doctor(client)))
|
|
@@ -35,3 +48,7 @@ catch (e) {
|
|
|
35
48
|
console.error(message.replace(/(?:sk|cln)-[A-Za-z0-9_-]+/g, "[REDACTED]"));
|
|
36
49
|
process.exitCode = 1;
|
|
37
50
|
}
|
|
51
|
+
finally {
|
|
52
|
+
for (const signal of signals)
|
|
53
|
+
process.removeListener(signal, abort);
|
|
54
|
+
}
|
package/dist/clients.d.ts
CHANGED
|
@@ -44,7 +44,7 @@ export interface ClientProfile {
|
|
|
44
44
|
label: string;
|
|
45
45
|
mode: InstallMode;
|
|
46
46
|
executable?: string;
|
|
47
|
-
adapter?: "codex" | "json" | "yaml";
|
|
47
|
+
adapter?: "codex" | "json" | "yaml" | "a1" | "b" | "c" | "warp" | "kiro";
|
|
48
48
|
}
|
|
49
49
|
export declare const clientProfiles: Record<Client, ClientProfile>;
|
|
50
50
|
export declare const skillTiers: Record<Client, SkillTier>;
|
package/dist/clients.js
CHANGED
|
@@ -2,57 +2,59 @@ export const clientProfiles = {
|
|
|
2
2
|
codex: { id: "codex", label: "Codex", mode: "auto", executable: "codex", adapter: "codex" },
|
|
3
3
|
"claude-code": { id: "claude-code", label: "Claude Code", mode: "auto", executable: "claude", adapter: "json" },
|
|
4
4
|
cursor: { id: "cursor", label: "Cursor", mode: "auto", executable: "cursor", adapter: "json" },
|
|
5
|
-
windsurf: { id: "windsurf", label: "Windsurf", mode: "
|
|
6
|
-
"gemini-cli": { id: "gemini-cli", label: "Gemini CLI", mode: "auto", executable: "gemini", adapter: "
|
|
7
|
-
opencode: { id: "opencode", label: "OpenCode", mode: "
|
|
5
|
+
windsurf: { id: "windsurf", label: "Windsurf", mode: "auto", executable: "windsurf", adapter: "a1" },
|
|
6
|
+
"gemini-cli": { id: "gemini-cli", label: "Gemini CLI", mode: "auto", executable: "gemini", adapter: "b" },
|
|
7
|
+
opencode: { id: "opencode", label: "OpenCode", mode: "auto", executable: "opencode2", adapter: "a1" },
|
|
8
8
|
chatgpt: { id: "chatgpt", label: "ChatGPT", mode: "manual" },
|
|
9
9
|
hermes: { id: "hermes", label: "Hermes", mode: "auto", executable: "hermes", adapter: "yaml" },
|
|
10
|
-
openclaw: { id: "openclaw", label: "OpenClaw", mode: "
|
|
10
|
+
openclaw: { id: "openclaw", label: "OpenClaw", mode: "auto", executable: "openclaw" },
|
|
11
11
|
antigravity: { id: "antigravity", label: "Antigravity", mode: "skill" },
|
|
12
|
-
"claude-desktop": { id: "claude-desktop", label: "Claude Desktop", mode: "
|
|
13
|
-
"cursor-cli": { id: "cursor-cli", label: "Cursor CLI", mode: "auto", executable: "cursor-agent", adapter: "
|
|
14
|
-
warp: { id: "warp", label: "Warp", mode: "
|
|
12
|
+
"claude-desktop": { id: "claude-desktop", label: "Claude Desktop", mode: "manual" },
|
|
13
|
+
"cursor-cli": { id: "cursor-cli", label: "Cursor CLI", mode: "auto", executable: "cursor-agent", adapter: "b" },
|
|
14
|
+
warp: { id: "warp", label: "Warp", mode: "auto", adapter: "warp" },
|
|
15
15
|
trae: { id: "trae", label: "Trae", mode: "skill" },
|
|
16
|
-
"kimi-cli": { id: "kimi-cli", label: "Kimi CLI", mode: "
|
|
17
|
-
"qwen-code": { id: "qwen-code", label: "Qwen Code", mode: "auto", executable: "qwen", adapter: "
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
16
|
+
"kimi-cli": { id: "kimi-cli", label: "Kimi CLI", mode: "auto", executable: "kimi", adapter: "b" },
|
|
17
|
+
"qwen-code": { id: "qwen-code", label: "Qwen Code", mode: "auto", executable: "qwen", adapter: "a1" },
|
|
18
|
+
kiro: { id: "kiro", label: "Kiro IDE", mode: "auto", adapter: "kiro" },
|
|
19
|
+
"kiro-cli": { id: "kiro-cli", label: "Kiro CLI", mode: "auto", executable: "kiro-cli", adapter: "b" },
|
|
20
|
+
amp: { id: "amp", label: "Amp", mode: "auto", executable: "amp", adapter: "c" },
|
|
21
|
+
crush: { id: "crush", label: "Crush", mode: "auto", executable: "crush", adapter: "c" },
|
|
22
|
+
"iflow-cli": { id: "iflow-cli", label: "iFlow CLI (legacy)", mode: "auto", executable: "iflow", adapter: "c" },
|
|
22
23
|
qoder: { id: "qoder", label: "Qoder", mode: "skill" },
|
|
23
24
|
workbuddy: { id: "workbuddy", label: "WorkBuddy", mode: "skill" },
|
|
24
25
|
cowork: { id: "cowork", label: "Cowork", mode: "manual" },
|
|
25
26
|
pi: { id: "pi", label: "Pi", mode: "skill" },
|
|
26
27
|
};
|
|
27
28
|
export const skillTiers = {
|
|
28
|
-
codex: "s3_promotion", "claude-code": "s1_slash", cursor: "s3_promotion", hermes: "
|
|
29
|
-
windsurf: "s4_none", "gemini-cli": "s4_none", opencode: "s4_none", chatgpt: "s4_none", openclaw: "
|
|
29
|
+
codex: "s3_promotion", "claude-code": "s1_slash", cursor: "s3_promotion", hermes: "s3_promotion",
|
|
30
|
+
windsurf: "s4_none", "gemini-cli": "s4_none", opencode: "s4_none", chatgpt: "s4_none", openclaw: "s3_promotion", antigravity: "s4_none", "claude-desktop": "s4_none", "cursor-cli": "s4_none", warp: "s4_none", trae: "s4_none", "kimi-cli": "s4_none", "qwen-code": "s4_none", kiro: "s3_promotion", "kiro-cli": "s4_none", amp: "s4_none", crush: "s4_none", "iflow-cli": "s4_none", qoder: "s4_none", workbuddy: "s4_none", cowork: "s4_none", pi: "s4_none",
|
|
30
31
|
};
|
|
31
32
|
const guide = (client, action, check) => `${client}: ${action} Completion check: ${check} Recovery: keep existing settings unchanged and retry after correcting the client setup.`;
|
|
32
33
|
export const nativeCapabilities = {
|
|
33
34
|
codex: { mcpMode: "auto", skillMode: "shared_skill", invocation: "skill_picker", verification: "read_only_probe", guide: guide("Codex", "Restart Codex and use its Skill picker to select SandBase; do not assume a slash command.", "SandBase MCP tools are visible in the session."), uninstall: "managed_only", terminal: "action_required" },
|
|
34
35
|
"claude-code": { mcpMode: "auto", skillMode: "client_skill", invocation: "slash", verification: "real_client_matrix", guide: guide("Claude Code", "Restart Claude Code; native Skill discovery remains unverified until the real-client matrix is complete.", "SandBase MCP tools and the private Skill are installed."), uninstall: "managed_only", terminal: "action_required" },
|
|
35
36
|
cursor: { mcpMode: "auto", skillMode: "shared_skill", invocation: "slash", verification: "real_client_matrix", guide: guide("Cursor", "Restart Cursor, type /, and look for /sandbase.", "A real-client matrix confirms /sandbase discovery and invocation."), uninstall: "managed_only", terminal: "action_required" },
|
|
36
|
-
"cursor-cli": { mcpMode: "
|
|
37
|
+
"cursor-cli": { mcpMode: "auto", skillMode: "none", invocation: "mcp_chat", verification: "read_only_probe", guide: guide("Cursor CLI", "Restart cursor-agent and inspect MCP servers/tools.", "cursor-agent mcp list and list-tools read back SandBase."), uninstall: "managed_only", terminal: "action_required" },
|
|
37
38
|
"gemini-cli": { mcpMode: "auto", skillMode: "none", invocation: "mcp_chat", verification: "read_only_probe", guide: guide("Gemini CLI", "Restart the CLI session and use the configured SandBase MCP tools.", "SandBase tools are listed by the client."), uninstall: "managed_only", terminal: "action_required" },
|
|
38
|
-
hermes: { mcpMode: "auto", skillMode: "
|
|
39
|
-
"claude-desktop": { mcpMode: "desktop", skillMode: "
|
|
40
|
-
"qwen-code": { mcpMode: "auto", skillMode: "none", invocation: "mcp_chat", verification: "read_only_probe", guide: guide("Qwen Code", "Restart Qwen Code
|
|
41
|
-
windsurf: { mcpMode: "
|
|
42
|
-
opencode: { mcpMode: "
|
|
39
|
+
hermes: { mcpMode: "auto", skillMode: "client_skill", invocation: "mcp_chat", verification: "real_client_matrix", guide: guide("Hermes", "Restart Hermes, then use the SandBase native Skill or configured MCP tools; native discovery requires the real-client matrix.", "The managed Hermes Skill and SandBase MCP entry are present."), uninstall: "managed_only", terminal: "action_required" },
|
|
40
|
+
"claude-desktop": { mcpMode: "desktop", skillMode: "client_skill", invocation: "desktop_ui", verification: "real_client_matrix", guide: guide("Claude Desktop", "Download and import the versioned MCP config and reviewed Skill, then restart the desktop app.", "Verify MCP and Skill separately in the real-client matrix."), uninstall: "managed_only", terminal: "action_required" },
|
|
41
|
+
"qwen-code": { mcpMode: "auto", skillMode: "none", invocation: "mcp_chat", verification: "read_only_probe", guide: guide("Qwen Code", "Restart Qwen Code, open /mcp, and inspect SandBase settings/tools.", "The user-scope SandBase server is present in /mcp and settings readback."), uninstall: "managed_only", terminal: "action_required" },
|
|
42
|
+
windsurf: { mcpMode: "auto", skillMode: "none", invocation: "desktop_ui", verification: "read_only_probe", guide: guide("Windsurf", "Restart Windsurf and inspect Cascade MCP Servers.", "The SandBase remote server and tools are visible."), uninstall: "managed_only", terminal: "action_required" },
|
|
43
|
+
opencode: { mcpMode: "auto", skillMode: "none", invocation: "mcp_chat", verification: "read_only_probe", guide: guide("OpenCode", "Restart OpenCode and inspect its MCP server list.", "opencode2 mcp list reads back SandBase."), uninstall: "managed_only", terminal: "action_required" },
|
|
43
44
|
chatgpt: { mcpMode: "manual", skillMode: "none", invocation: "none", verification: "user_action", guide: guide("ChatGPT", "No verified safe personal/workspace MCP import path is available.", "Do not add unverified configuration."), uninstall: "managed_only", terminal: "unsupported" },
|
|
44
|
-
warp: { mcpMode: "
|
|
45
|
+
warp: { mcpMode: "auto", skillMode: "none", invocation: "desktop_ui", verification: "read_only_probe", guide: guide("Warp", "Approve the managed server with /agent-add-mcp, then inspect Warp's MCP server and tool readback.", "The owned user entry is present and Warp lists SandBase tools without a project override."), uninstall: "managed_only", terminal: "action_required" },
|
|
45
46
|
trae: { mcpMode: "none", skillMode: "prompt", invocation: "prompt", verification: "user_action", guide: guide("Trae", "Paste a SandBase MCP usage prompt into the client after configuring its supported integration.", "The client confirms the prompt or tool availability."), uninstall: "managed_only", terminal: "action_required" },
|
|
46
|
-
"kimi-cli": { mcpMode: "
|
|
47
|
-
"kiro-cli": { mcpMode: "
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
47
|
+
"kimi-cli": { mcpMode: "auto", skillMode: "none", invocation: "mcp_chat", verification: "read_only_probe", guide: guide("Kimi CLI", "Restart Kimi and inspect its persistent MCP list/test output.", "kimi mcp list/test read back SandBase tools."), uninstall: "managed_only", terminal: "action_required" },
|
|
48
|
+
"kiro-cli": { mcpMode: "auto", skillMode: "client_skill", invocation: "mcp_chat", verification: "read_only_probe", guide: guide("Kiro CLI", "Use the independently verified native Skill and hot-reloaded global SandBase MCP server.", "Skills CLI verifies the immutable SandBase source while kiro-cli mcp list/status independently reads back MCP."), uninstall: "managed_only", terminal: "action_required" },
|
|
49
|
+
kiro: { mcpMode: "auto", skillMode: "client_skill", invocation: "desktop_ui", verification: "real_client_matrix", guide: guide("Kiro IDE", "Reload Kiro after the owned user MCP entry and user Skill pass readback; resolve any workspace override first.", "Kiro IDE lists SandBase server/tools and completes a safe tool call."), uninstall: "managed_only", terminal: "action_required" },
|
|
50
|
+
amp: { mcpMode: "auto", skillMode: "none", invocation: "mcp_chat", verification: "read_only_probe", guide: guide("Amp", "Restart Amp after the global JSON/JSONC entry passes amp mcp doctor.", "The owned global bridge is effective without a workspace or managed-policy override."), uninstall: "managed_only", terminal: "action_required" },
|
|
51
|
+
crush: { mcpMode: "auto", skillMode: "none", invocation: "mcp_chat", verification: "read_only_probe", guide: guide("Crush", "Restart Crush after the global static stdio entry is installed.", "The exact owned entry is effective without a project override; real tools require client validation."), uninstall: "managed_only", terminal: "action_required" },
|
|
52
|
+
"iflow-cli": { mcpMode: "auto", skillMode: "none", invocation: "mcp_chat", verification: "read_only_probe", guide: guide("iFlow CLI (legacy)", "Use only an existing compatible installation with Node.js 22+ and user-provided model access; vendor service ended 2026-04-17.", "iflow mcp get/list reads back the user-scope SandBase bridge; real tools remain subject to post-release user validation."), uninstall: "managed_only", terminal: "action_required" },
|
|
51
53
|
qoder: { mcpMode: "none", skillMode: "prompt", invocation: "prompt", verification: "user_action", guide: guide("Qoder", "Paste the SandBase MCP usage prompt into Qoder.", "Qoder confirms the prompt or tool availability."), uninstall: "managed_only", terminal: "action_required" },
|
|
52
54
|
workbuddy: { mcpMode: "none", skillMode: "prompt", invocation: "prompt", verification: "user_action", guide: guide("WorkBuddy", "Paste the SandBase MCP usage prompt into WorkBuddy.", "WorkBuddy confirms the prompt or tool availability."), uninstall: "managed_only", terminal: "action_required" },
|
|
53
|
-
cowork: { mcpMode: "
|
|
55
|
+
cowork: { mcpMode: "desktop", skillMode: "client_skill", invocation: "desktop_ui", verification: "real_client_matrix", guide: guide("Cowork", "Download the versioned MCP config and reviewed Skill, then use the supported account or administrator import flow.", "Verify MCP and Skill separately in the real-client matrix."), uninstall: "managed_only", terminal: "action_required" },
|
|
54
56
|
pi: { mcpMode: "none", skillMode: "prompt", invocation: "prompt", verification: "user_action", guide: guide("Pi", "Paste the SandBase MCP usage prompt into Pi.", "Pi confirms the prompt or tool availability."), uninstall: "managed_only", terminal: "action_required" },
|
|
55
|
-
openclaw: { mcpMode: "
|
|
57
|
+
openclaw: { mcpMode: "auto", skillMode: "client_skill", invocation: "mcp_chat", verification: "real_client_matrix", guide: guide("OpenClaw", "Restart OpenClaw after SandBase reads back its MCP bridge and ClawHub Skill; then use a natural-language SandBase request.", "OpenClaw reads back the managed MCP bridge and the exact SandBase ClawHub Skill identity."), uninstall: "managed_only", terminal: "action_required" },
|
|
56
58
|
antigravity: { mcpMode: "none", skillMode: "prompt", invocation: "prompt", verification: "user_action", guide: guide("Antigravity", "Paste the SandBase MCP usage prompt into Antigravity.", "Antigravity confirms the prompt or tool availability."), uninstall: "managed_only", terminal: "action_required" },
|
|
57
59
|
};
|
|
58
60
|
function v2(client, capability) {
|
|
@@ -60,8 +62,24 @@ function v2(client, capability) {
|
|
|
60
62
|
codex: { source: "https://developers.openai.com/codex/skills/", retrieved: "2026-07-29", conclusion: "Codex supports SKILL.md; the existing B-063 adapter provides the MCP transaction.", kind: "first_party" },
|
|
61
63
|
"claude-code": { source: "https://docs.anthropic.com/en/docs/claude-code/skills", retrieved: "2026-07-29", conclusion: "Personal Skills use ~/.claude/skills/<skill-name>/SKILL.md and the directory name maps to its command.", kind: "first_party" },
|
|
62
64
|
cursor: { source: "https://docs.cursor.com/context/skills", retrieved: "2026-07-28", conclusion: "The user-level ~/.agents/skills root is discovered by Cursor; UI discovery remains subject to the real-client matrix.", kind: "first_party" },
|
|
65
|
+
hermes: { source: "Hermes Agent CLI v0.10.0 local help and installed source", retrieved: "2026-07-29", conclusion: "Hermes uses a managed local Skill under HERMES_HOME and the existing YAML stdio MCP adapter; UI discovery remains subject to the real-client matrix.", kind: "first_party" },
|
|
66
|
+
openclaw: { source: "OpenClaw 2026.4.12 local help and installed source", retrieved: "2026-07-30", conclusion: "OpenClaw supports `mcp set/show/unset` plus ClawHub Skill installation/readback; SandBase configures both through the existing CLI authorization transaction.", kind: "first_party" },
|
|
67
|
+
"claude-desktop": { source: "B-079 feature design r2", retrieved: "2026-07-30", conclusion: "Claude Desktop uses the shared local bridge credential lifecycle and a separate versioned artifact import transaction.", kind: "first_party" },
|
|
68
|
+
cowork: { source: "B-079 feature design r2", retrieved: "2026-07-30", conclusion: "Cowork uses the shared local bridge credential lifecycle and its independent account or administrator import transaction.", kind: "first_party" },
|
|
69
|
+
opencode: { source: "https://opencode.ai/v2/docs/mcp-servers", retrieved: "2026-07-30", conclusion: "OpenCode V2 supports global MCP configuration and independent CLI list readback.", kind: "first_party" },
|
|
70
|
+
"qwen-code": { source: "https://qwenlm.github.io/qwen-code-docs/en/users/features/mcp/", retrieved: "2026-07-30", conclusion: "Qwen Code supports explicit user-scope MCP add/remove and /mcp settings readback.", kind: "first_party" },
|
|
71
|
+
windsurf: { source: "https://docs.windsurf.com/windsurf/cascade/mcp", retrieved: "2026-07-30", conclusion: "Windsurf supports a user mcp_config.json remote server schema with file credential interpolation.", kind: "first_party" },
|
|
72
|
+
"gemini-cli": { source: "https://geminicli.com/docs/tools/mcp-server/", retrieved: "2026-07-30", conclusion: "Gemini CLI supports explicit user-scope persistent MCP add/list/remove.", kind: "first_party" },
|
|
73
|
+
"cursor-cli": { source: "https://docs.cursor.com/en/cli/using", retrieved: "2026-07-30", conclusion: "cursor-agent consumes the shared user .cursor/mcp.json and exposes independent MCP list/list-tools readback.", kind: "first_party" },
|
|
74
|
+
"kimi-cli": { source: "https://moonshotai.github.io/kimi-cli/en/reference/kimi-mcp.html", retrieved: "2026-07-30", conclusion: "Kimi Code CLI supports persistent MCP add/list/test/remove through the kimi executable.", kind: "first_party" },
|
|
75
|
+
"kiro-cli": { source: "https://kiro.dev/docs/cli/mcp/configuration/", retrieved: "2026-07-30", conclusion: "Kiro CLI supports global command MCP add/list/status/remove and hot reload with KIRO_HOME precedence.", kind: "first_party" },
|
|
76
|
+
kiro: { source: "https://kiro.dev/docs/mcp/configuration/", retrieved: "2026-07-31", conclusion: "Kiro IDE supports user MCP settings, higher-priority workspace settings, and user Skills independently of kiro-cli.", kind: "first_party" },
|
|
77
|
+
amp: { source: "https://ampcode.com/manual", retrieved: "2026-07-30", conclusion: "Amp supports global JSON/JSONC stdio MCP configuration and mcp doctor readback, with higher-priority workspace and managed-policy constraints.", kind: "first_party" },
|
|
78
|
+
crush: { source: "https://github.com/charmbracelet/crush/blob/main/schema.json", retrieved: "2026-07-30", conclusion: "Crush supports a global top-level mcp stdio schema with project precedence; SandBase writes only static argv and never shell expansion.", kind: "first_party" },
|
|
79
|
+
"iflow-cli": { source: "https://github.com/iflow-ai/iflow-cli/blob/main/docs_en/examples/mcp.md", retrieved: "2026-07-30", conclusion: "The discontinued iFlow CLI exposes user-scope add-json/get/list/remove for existing legacy installations; vendor maintenance and service availability are not claimed.", kind: "first_party" },
|
|
80
|
+
warp: { source: "https://docs.warp.dev/agent-platform/capabilities/mcp/", retrieved: "2026-07-30", conclusion: "Warp supports user-level ~/.warp/.mcp.json command servers and explicit /agent-add-mcp approval/readback.", kind: "first_party" },
|
|
63
81
|
};
|
|
64
|
-
const implemented = client === "codex" || client === "claude-code" || client === "cursor";
|
|
82
|
+
const implemented = client === "codex" || client === "claude-code" || client === "cursor" || client === "hermes" || client === "openclaw" || client === "claude-desktop" || client === "cowork" || client === "opencode" || client === "qwen-code" || client === "windsurf" || client === "gemini-cli" || client === "cursor-cli" || client === "kimi-cli" || client === "kiro" || client === "kiro-cli" || client === "amp" || client === "crush" || client === "iflow-cli" || client === "warp";
|
|
65
83
|
const blocker = client === "cursor-cli" ? "Cursor CLI MCP installation is blocked until an independent first-party schema is recorded; desktop Cursor configuration must not be reused." : "This client batch has no completed installer and validator in the current iteration.";
|
|
66
84
|
if (!implemented)
|
|
67
85
|
return {
|
|
@@ -69,9 +87,12 @@ function v2(client, capability) {
|
|
|
69
87
|
installer: { mcp: "none", skill: "none" }, validator: { mcp: "none", skill: "none" }, implementation: "blocked", status: "failed", nextStep: blocker,
|
|
70
88
|
};
|
|
71
89
|
const hasSkill = capability.skillMode === "shared_skill" || capability.skillMode === "client_skill";
|
|
90
|
+
const desktop = client === "claude-desktop" || client === "cowork";
|
|
91
|
+
const skillInstaller = !hasSkill ? "none" : desktop ? "confirmation" : client === "claude-code" || client === "hermes" ? "private" : "shared";
|
|
92
|
+
const skillValidator = !hasSkill ? "none" : desktop || client === "cursor" || client === "claude-code" || client === "hermes" || client === "openclaw" ? "real_client_matrix" : "ownership_checksum";
|
|
72
93
|
return {
|
|
73
|
-
evidence: evidence[client], installer: { mcp:
|
|
74
|
-
validator: { mcp: "read_back", skill:
|
|
94
|
+
evidence: evidence[client], installer: { mcp: desktop ? "confirmation" : "adapter", skill: skillInstaller },
|
|
95
|
+
validator: { mcp: "read_back", skill: skillValidator }, implementation: "implemented", status: "confirmation_required",
|
|
75
96
|
nextStep: capability.guide,
|
|
76
97
|
};
|
|
77
98
|
}
|
package/dist/commands.d.ts
CHANGED
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
import { type Client, type ConnectClient } from "./types.js";
|
|
2
2
|
import { AuthorizationApi } from "./auth/api.js";
|
|
3
3
|
import { type CredentialStore } from "./credentials/store.js";
|
|
4
|
-
import { type
|
|
4
|
+
import { type A1CommandRunner } from "./a1-adapters.js";
|
|
5
|
+
import { type BCommandRunner } from "./b-adapters.js";
|
|
6
|
+
import { type CCommandRunner } from "./c-adapters.js";
|
|
7
|
+
import { type OpenClawCommandRunner, type OpenClawReadbackVerifier, type SkillsCommandRunner, type SkillsReadbackVerifier } from "./skills-cli.js";
|
|
5
8
|
type Detection = {
|
|
6
9
|
installed: boolean;
|
|
7
10
|
detail: string;
|
|
@@ -15,9 +18,14 @@ export interface CommandDependencies {
|
|
|
15
18
|
detect?: (client: Client) => Detection;
|
|
16
19
|
skillsRunner?: SkillsCommandRunner;
|
|
17
20
|
skillsReadbackVerifier?: SkillsReadbackVerifier;
|
|
21
|
+
openClawRunner?: OpenClawCommandRunner;
|
|
22
|
+
openClawReadbackVerifier?: OpenClawReadbackVerifier;
|
|
23
|
+
a1Runner?: A1CommandRunner;
|
|
24
|
+
bRunner?: BCommandRunner;
|
|
25
|
+
cRunner?: CCommandRunner;
|
|
18
26
|
}
|
|
19
27
|
export declare function openBrowser(url: string): Promise<void>;
|
|
20
28
|
export declare function connect(client?: ConnectClient, deps?: CommandDependencies): Promise<void>;
|
|
21
|
-
export declare function doctor(client?: ConnectClient, store?: CredentialStore, detect?: (client: Client) => Detection, skillsRunner?: SkillsCommandRunner, skillsReadbackVerifier?: SkillsReadbackVerifier): Promise<boolean>;
|
|
22
|
-
export declare function unregister(client?: ConnectClient, store?: CredentialStore, detect?: (client: Client) => Detection, skillsRunner?: SkillsCommandRunner, skillsReadbackVerifier?: SkillsReadbackVerifier): Promise<void>;
|
|
29
|
+
export declare function doctor(client?: ConnectClient, store?: CredentialStore, detect?: (client: Client) => Detection, skillsRunner?: SkillsCommandRunner, skillsReadbackVerifier?: SkillsReadbackVerifier, openClawRunner?: OpenClawCommandRunner, openClawReadbackVerifier?: OpenClawReadbackVerifier, a1Runner?: A1CommandRunner, bRunner?: BCommandRunner, cRunner?: CCommandRunner): Promise<boolean>;
|
|
30
|
+
export declare function unregister(client?: ConnectClient, store?: CredentialStore, detect?: (client: Client) => Detection, skillsRunner?: SkillsCommandRunner, skillsReadbackVerifier?: SkillsReadbackVerifier, openClawRunner?: OpenClawCommandRunner, openClawReadbackVerifier?: OpenClawReadbackVerifier, a1Runner?: A1CommandRunner, bRunner?: BCommandRunner, cRunner?: CCommandRunner): Promise<void>;
|
|
23
31
|
export {};
|