@supercollab/cli 0.4.5 → 0.4.6

package/README.md

@@ -149,6 +149,18 @@ opening Claude, verify the local MCP handshake:
 supercollab mcp smoke
 ```
 
+For Claude Code, install the MCP server from the project directory:
+
+```bash
+cd /path/to/project
+supercollab mcp install --client claude-code
+```
+
+The installer first runs the MCP smoke check, then calls Claude Code's own
+`claude mcp add` with absolute Node and CLI paths plus explicit `HOME`, `PATH`,
+and `SUPERCOLLAB_WORKDIR` values. This avoids Homebrew, nvm, shell startup, and
+GUI path differences.
+
 Default server: `https://hyper.polynode.dev`.
 
 Local config is stored at `~/.supercollab/config.json` with mode `0600`; the

package/bin/supercollab.js

@@ -8,7 +8,7 @@ import { fileURLToPath } from 'node:url';
 import * as readlineCore from 'node:readline';
 import { stdin as input, stdout as output } from 'node:process';
 
-const VERSION = '0.4.5';
+const VERSION = '0.4.6';
 const CLI_ENTRY = fileURLToPath(import.meta.url);
 const DEFAULT_SERVER = process.env.SUPERCOLLAB_URL || 'https://hyper.polynode.dev';
 const DEFAULT_CONFIG = process.env.SUPERCOLLAB_CONFIG || path.join(os.homedir(), '.supercollab', 'config.json');
@@ -61,6 +61,7 @@ Usage:
   supercollab embeddings status
   supercollab embeddings warmup
   supercollab mcp stdio
+  supercollab mcp install --client claude-code [--scope local] [--cwd PATH]
   supercollab mcp print-config --client codex
   supercollab mcp smoke [--timeout 5000]
   supercollab config path
@@ -1796,9 +1797,120 @@ function mcpConfigText(client, file, opts = {}) {
   if (client === 'codex') {
     return `[mcp_servers.supercollab]\ncommand = "supercollab"\nargs = ["mcp", "stdio", "--config", "${escaped}"]`;
   }
+  if (client === 'claude-code') {
+    const install = claudeCodeInstallPlan(file, opts);
+    return shellCommand(install.command, install.args);
+  }
   return `supercollab mcp stdio --config "${escaped}"`;
 }
 
+function shellQuote(value) {
+  const text = String(value);
+  if (/^[A-Za-z0-9_./:=@%+-]+$/.test(text)) return text;
+  return `'${text.replaceAll("'", "'\\''")}'`;
+}
+
+function shellCommand(command, args = []) {
+  return [command, ...args].map(shellQuote).join(' ');
+}
+
+function claudeCodeMcpEnv(opts = {}) {
+  const cwd = path.resolve(String(opts.cwd || process.env.SUPERCOLLAB_WORKDIR || process.cwd()));
+  return {
+    HOME: os.homedir(),
+    PATH: defaultPathEnv(),
+    SUPERCOLLAB_WORKDIR: cwd,
+  };
+}
+
+function claudeCodeInstallPlan(file, opts = {}) {
+  const scope = String(opts.scope || 'local');
+  const claude = String(opts.claude || 'claude');
+  const env = claudeCodeMcpEnv(opts);
+  const args = [
+    'mcp', 'add',
+    '--scope', scope,
+    '--transport', 'stdio',
+    '--env', `HOME=${env.HOME}`,
+    '--env', `PATH=${env.PATH}`,
+    '--env', `SUPERCOLLAB_WORKDIR=${env.SUPERCOLLAB_WORKDIR}`,
+    'supercollab',
+    '--',
+    process.execPath,
+    CLI_ENTRY,
+    'mcp',
+    'stdio',
+    '--config',
+    path.resolve(file),
+  ];
+  return { command: claude, args, env, scope, cwd: env.SUPERCOLLAB_WORKDIR };
+}
+
+function runProcess(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'pipe'],
+    ...options,
+  });
+  return {
+    ok: result.status === 0,
+    status: result.status,
+    signal: result.signal,
+    stdout: String(result.stdout || '').trim(),
+    stderr: String(result.stderr || '').trim(),
+    error: result.error?.message || null,
+  };
+}
+
+async function installClaudeCodeMcp(config, file, opts = {}) {
+  const client = String(opts.client || 'claude-code');
+  if (!['claude-code', 'claude'].includes(client)) throw new Error(`unsupported mcp install client: ${client}`);
+  const plan = claudeCodeInstallPlan(file, opts);
+  const dryRun = Boolean(opts['dry-run'] || opts.dryRun);
+  const smoke = await runMcpSmoke({ ...opts, config: file, timeout: opts.timeout || 5000 });
+  const removeArgs = ['mcp', 'remove', 'supercollab', '--scope', plan.scope];
+
+  if (dryRun) {
+    return {
+      ok: true,
+      dry_run: true,
+      client: 'claude-code',
+      smoke,
+      remove_command: shellCommand(plan.command, removeArgs),
+      install_command: shellCommand(plan.command, plan.args),
+      scope: plan.scope,
+      cwd: plan.cwd,
+      config: path.resolve(file),
+    };
+  }
+
+  const probe = runProcess(plan.command, ['--version'], { cwd: plan.cwd });
+  if (!probe.ok) {
+    throw new Error(`Claude Code CLI not found or not runnable as ${plan.command}. Install Claude Code first, or pass --claude /absolute/path/to/claude. ${probe.stderr || probe.error || ''}`.trim());
+  }
+
+  runProcess(plan.command, removeArgs, { cwd: plan.cwd });
+  const add = runProcess(plan.command, plan.args, { cwd: plan.cwd });
+  if (!add.ok) {
+    throw new Error(`claude mcp add failed: ${add.stderr || add.stdout || add.error || `exit ${add.status}`}`);
+  }
+  const list = runProcess(plan.command, ['mcp', 'list'], { cwd: plan.cwd });
+  const get = runProcess(plan.command, ['mcp', 'get', 'supercollab'], { cwd: plan.cwd });
+  return {
+    ok: true,
+    client: 'claude-code',
+    scope: plan.scope,
+    cwd: plan.cwd,
+    config: path.resolve(file),
+    smoke,
+    install_command: shellCommand(plan.command, plan.args),
+    claude_add: { stdout: add.stdout, stderr: add.stderr },
+    claude_list: { ok: list.ok, stdout: list.stdout, stderr: list.stderr },
+    claude_get: { ok: get.ok, stdout: get.stdout, stderr: get.stderr },
+    next: 'Start Claude Code in this project, or run /mcp inside Claude Code and confirm supercollab is connected.',
+  };
+}
+
 async function promptSystemCheck(config, file, prompts) {
   const spin = prompts.spinner();
   spin.start('Checking this machine and warming the local BGE model');
@@ -2100,6 +2212,7 @@ async function promptMcpConfig(config, file, prompts) {
   const client = await prompts.select({
     message: 'MCP client config',
     options: [
+      { value: 'claude-code', label: 'Claude Code', hint: 'one-command installer' },
       { value: 'codex', label: 'Codex', hint: 'TOML config snippet' },
       { value: 'claude', label: 'Claude', hint: 'JSON config snippet' },
       { value: 'manual', label: 'Manual', hint: 'stdio command' },
@@ -2110,6 +2223,42 @@ async function promptMcpConfig(config, file, prompts) {
   prompts.note(mcpConfigText(client, file), `${client} MCP config`);
 }
 
+async function promptInstallClaudeCode(config, file, prompts) {
+  const cwd = await prompts.text({
+    message: 'Claude Code project directory',
+    defaultValue: process.cwd(),
+    placeholder: process.cwd(),
+    validate: (value) => fs.existsSync(path.resolve(String(value || ''))) ? undefined : 'Directory does not exist',
+  });
+  if (prompts.isCancel(cwd)) throw new Error('cancelled');
+  const scope = await prompts.select({
+    message: 'Claude Code MCP scope',
+    options: [
+      { value: 'local', label: 'Local project', hint: 'recommended; private to this project' },
+      { value: 'user', label: 'User', hint: 'available across your projects' },
+    ],
+  });
+  if (prompts.isCancel(scope)) throw new Error('cancelled');
+  const spin = prompts.spinner();
+  spin.start('Installing SuperCollab into Claude Code');
+  try {
+    const result = await installClaudeCodeMcp(config, file, { client: 'claude-code', cwd: String(cwd), scope });
+    spin.stop('Claude Code MCP installed');
+    prompts.note([
+      `Scope: ${result.scope}`,
+      `Project: ${result.cwd}`,
+      `Smoke: ${result.smoke?.ok ? 'ok' : 'failed'}`,
+      result.claude_list?.stdout || '',
+      '',
+      result.next,
+    ].filter(Boolean).join('\n'), 'Claude Code');
+    return result;
+  } catch (err) {
+    spin.stop('Claude Code install failed');
+    throw err;
+  }
+}
+
 function sessionsFromResponse(data) {
   if (Array.isArray(data)) return data;
   if (Array.isArray(data?.sessions)) return data.sessions;
@@ -2258,6 +2407,7 @@ async function runSettingsMenu(config, file, prompts) {
       options: [
         { value: 'doctor', label: 'System check / install BGE model' },
         { value: 'account', label: 'Account and config status' },
+        { value: 'install_claude_code', label: 'Install Claude Code MCP' },
         { value: 'mcp', label: 'Show MCP config' },
         { value: 'sessions', label: 'Manage sessions' },
         { value: 'server', label: 'Set server URL' },
@@ -2268,6 +2418,7 @@ async function runSettingsMenu(config, file, prompts) {
     try {
       if (action === 'doctor') await promptSystemCheck(config, file, prompts);
       if (action === 'account') await promptAccountStatus(config, file, prompts);
+      if (action === 'install_claude_code') await promptInstallClaudeCode(config, file, prompts);
       if (action === 'mcp') await promptMcpConfig(config, file, prompts);
       if (action === 'sessions') await promptManageSessions(config, prompts);
       if (action === 'server') await promptSetServerUrl(config, file, prompts);
@@ -2344,6 +2495,7 @@ async function runSetupWizard(config, file, opts = {}) {
     const client = await prompts.select({
       message: 'MCP client config',
       options: [
+        { value: 'claude-code', label: 'Claude Code', hint: 'one-command installer' },
         { value: 'codex', label: 'Codex', hint: 'TOML config snippet' },
         { value: 'claude', label: 'Claude', hint: 'JSON config snippet' },
         { value: 'manual', label: 'Manual', hint: 'stdio command' },
@@ -2432,6 +2584,7 @@ async function main() {
     if (sub === 'warmup') return console.log(JSON.stringify(await embeddingWarmup(), null, 2));
   }
   if (cmd === 'mcp' && sub === 'stdio') return runMcp(opts);
+  if (cmd === 'mcp' && sub === 'install') return console.log(JSON.stringify(await installClaudeCodeMcp(config, file, opts), null, 2));
   if (cmd === 'mcp' && sub === 'smoke') return console.log(JSON.stringify(await runMcpSmoke(opts), null, 2));
   if (cmd === 'mcp' && sub === 'print-config') return printCodexConfig(opts);
   throw new Error(`unknown command: ${positionals.join(' ')}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supercollab/cli",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "SuperCollab CLI and MCP bridge for encrypted local-search agent group chat.",
   "type": "module",
   "bin": {