@m2canvas/connect 0.2.0 → 0.3.0

package/README.md

@@ -10,7 +10,7 @@ It finds the supported clients you have installed, shows what it will change, an
 
 **In a terminal**, it asks before changing anything and opens each client's browser sign-in, so one command finishes the whole setup.
 
-**Run by an agent** (no interactive terminal, e.g. pasted from M2's "Copy to agent"), it adds the server to every client without asking, skips the sign-ins it can't run there, and prints the remaining steps: a command to run (Codex, Cursor, OpenCode) or a place to click in the app (Claude Code, Qoder). The agent can run the commands or pass the steps on to you. Running it again lists the sign-in steps for clients that were already added.
+**Run by an agent** (no interactive terminal, e.g. pasted from M2's "Copy to agent"), the agent passes `--client <id>` (`claude-code`, `codex`, `cursor`, `opencode`, `qoder`) so only its own client is touched. It adds the server without asking, skips the sign-ins it can't run there, and prints the remaining steps: a command to run (Codex, Cursor, OpenCode) or a place to click in the app (Claude Code, Qoder). The agent can run the commands or pass the steps on to you. Running it again lists the sign-in steps for clients that were already added.
 
 | Client | How it is set up | Sign-in |
 |---|---|---|
@@ -22,6 +22,6 @@ It finds the supported clients you have installed, shows what it will change, an
 
 Clients that already have an entry pointing at `mcp.m2ui.ai`, under any name, are skipped. Before a config file is edited, the original is copied to `<file>.bak-m2canvas`.
 
-Options: `--dry-run` shows the plan without changing anything; `--yes` skips the confirmation.
+Options: `--client <id>` sets up only that client; `--dry-run` shows the plan without changing anything; `--yes` skips the confirmation.
 
 After setup, restart each client so it loads the new server.

package/dist/cli.js

@@ -8,9 +8,10 @@
 //     所以只写入配置，把剩余授权步骤打印成 agent 可以照做 / 转述给用户的清单。
 import { createInterface } from 'node:readline/promises';
 import { M2_MCP_URL, SERVER_NAME } from './config-files.js';
-import { detectClients } from './clients.js';
+import { CLIENTS, detectClients, isClientId } from './clients.js';
 import { run } from './system.js';
-const HELP = `Usage: npx @m2canvas/connect [--yes] [--dry-run]
+const CLIENT_IDS = Object.keys(CLIENTS).join(', ');
+const HELP = `Usage: npx @m2canvas/connect [--client <id>] [--yes] [--dry-run]
 
 Adds M2 Canvas (${M2_MCP_URL}) to every agent client found on this machine
 (Claude Code, Codex, Cursor, OpenCode, Qoder), then signs each one in.
@@ -19,6 +20,7 @@ In a terminal it asks before changing anything and opens each sign-in in your br
 When run by an agent (no terminal), it only adds the server and prints the remaining
 sign-in steps.
 
+  --client <id>  only set up this client (${CLIENT_IDS})
   -y, --yes      skip the confirmation prompt
   --dry-run      only show what would change
   -h, --help     show this help`;
@@ -59,13 +61,27 @@ function describePending(step) {
     return step.manual ?? '';
 }
 async function main() {
-    const args = new Set(process.argv.slice(2));
+    const argv = process.argv.slice(2);
+    const args = new Set(argv);
     if (args.has('-h') || args.has('--help')) {
         console.log(HELP);
         return 0;
     }
     const interactive = Boolean(process.stdin.isTTY);
-    const plans = detectClients();
+    // agent 代跑时由起手式带上自己的 --client：只处理这一家，其他客户端不动、不提 ——
+    // 用户只是在一个客户端里粘了一段话，不该顺带改掉、也不该被列出别的客户端。
+    const clientIndex = argv.indexOf('--client');
+    const requested = clientIndex >= 0 ? (argv[clientIndex + 1] ?? '') : null;
+    if (requested !== null && !isClientId(requested)) {
+        console.error(`Unknown --client "${requested}". Use one of: ${CLIENT_IDS}.`);
+        return 2;
+    }
+    const only = requested ?? undefined;
+    const plans = detectClients(only);
+    if (only && plans.length === 0) {
+        console.log(`Couldn't find a working ${only} CLI on this machine.\nAdd this MCP server by hand instead: ${M2_MCP_URL} (streamable HTTP, OAuth sign-in).`);
+        return 1;
+    }
     if (plans.length === 0) {
         console.log(`No supported agent client found.\nAdd this MCP server in your client by hand: ${M2_MCP_URL} (streamable HTTP, OAuth sign-in).`);
         return 1;

package/dist/clients.js

@@ -136,6 +136,18 @@ function cursor() {
         },
     };
 }
-export function detectClients() {
-    return [claudeCode(), codex(), cursor(), opencode(), qoder()].filter((plan) => plan !== null);
+/** `--client` 的取值 → 探测函数。探测会真跑 `--version`，所以按需只跑被点名的那家。 */
+export const CLIENTS = {
+    'claude-code': claudeCode,
+    codex,
+    cursor,
+    opencode,
+    qoder,
+};
+export function isClientId(value) {
+    return Object.hasOwn(CLIENTS, value);
+}
+export function detectClients(only) {
+    const ids = only ? [only] : Object.keys(CLIENTS);
+    return ids.map((id) => CLIENTS[id]()).filter((plan) => plan !== null);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m2canvas/connect",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Connect your local agent clients (Claude Code, Codex, Cursor, OpenCode, Qoder) to M2 Canvas over MCP in one command.",
   "type": "module",
   "bin": {