@predotdev/mcp 2.0.2 → 2.1.0

package/README.md

@@ -31,7 +31,7 @@ One MCP server gives your coding agent everything pre.dev does:
 - **Browser Agents in the cloud.** Send a URL and a task to pre.dev's browsers and get structured data back, many runs in parallel.
 - **Specs and plans.** Plan an app or feature before building it: architecture, tech stack, milestones and user stories.
 
-It works with **any coding agent that runs MCP servers locally**: Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, OpenCode, Claude Desktop, the [pre.dev CLI](https://pre.dev) and more. Run as many agents as you like at the same time. They all share one connection to Chrome, so Chrome only asks you to allow it once.
+It works with **any coding agent**: Claude Code, Codex, Hermes, Pi, OpenClaw, Cursor, GitHub Copilot, Cline, Gemini CLI and Antigravity, OpenCode, Zed, Goose, the [pre.dev CLI](https://pre.dev) and 20 more, and any agent that can run a shell command. Run as many agents as you like at the same time. They all share one connection to Chrome, so Chrome only asks you to allow it once.
 
 Built with the [pre.dev CLI](https://docs.pre.dev/cli/overview).
 
@@ -46,7 +46,7 @@ npx -y @predotdev/mcp setup
 It walks you through everything:
 
 1. **Signs you in to pre.dev** in your browser (or creates a free account). Approve, and your key is saved for every agent. Nothing to copy. Already signed in to the pre.dev CLI? It uses that login.
-2. **Adds it to every coding agent on your Mac**: Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, OpenCode, Claude Desktop and the pre.dev CLI. Already using the hosted pre.dev MCP? This one includes all of its tools, so setup replaces it.
+2. **Adds it to every coding agent on your Mac**: Claude Code, Codex, Hermes, Pi, OpenClaw, Cursor, Copilot CLI, Cline, Antigravity, Gemini CLI, OpenCode, VS Code, Claude Desktop, the pre.dev CLI and more (28 in all; [list](#setup-for-every-agent)). Already using the hosted pre.dev MCP? This one includes all of its tools, so setup replaces it.
 3. **Connects to Chrome.** The first time, it asks you to turn on remote debugging at `chrome://inspect/#remote-debugging` (it copies the address for you), and Chrome asks **"Allow remote debugging?"**: click **Allow**.
 
 Then restart your agent and try:
@@ -138,6 +138,8 @@ Once you are signed in to pre.dev (`setup` or `login` does it, or set `PREDEV_AP
 npx -y @predotdev/mcp        env: PREDEV_API_KEY=your_key   (optional after login)
 ```
 
+`setup` finds and configures each of these that is installed: Claude Code, Codex, Hermes, Pi, OpenClaw, Cursor (editor and CLI), Windsurf, GitHub Copilot CLI, Antigravity, Gemini CLI, Cline, Kiro, Qwen Code, Factory Droid, Augment, Amp, Kilo Code, Kimi Code, Junie, Warp, Rovo Dev, OpenHands, LM Studio, OpenCode, VS Code, VS Code Insiders, Claude Desktop and the pre.dev CLI. Devin CLI, Grok Build and Warp also read Claude Code's or Cursor's config, so they pick it up from there. Zed's settings file usually has comments, so `setup` leaves it to you (below).
+
 <details>
 <summary><b>Claude Code</b></summary>
 
@@ -147,10 +149,34 @@ claude mcp add --scope user predev -e PREDEV_API_KEY=your_key -- npx -y @predotd
 
 </details>
 
+<details>
+<summary><b>Hermes</b></summary>
+
+```bash
+hermes mcp add predev --command npx --args -y @predotdev/mcp
+hermes config set mcp_servers.predev.timeout 900
+```
+
+Answer `Y` to turn on its tools. The longer timeout gives specs and cloud runs time to finish. In a running chat, `/reload-mcp` picks it up.
+
+</details>
+
+<details>
+<summary><b>Pi</b></summary>
+
+```bash
+pi mcp add predev -- npx -y @predotdev/mcp
+pi mcp list
+```
+
+`pi mcp list` should say `predev: connected`. Pi versions without built-in MCP need `pi install npm:pi-mcp-adapter` first; it reads the same `~/.pi/agent/mcp.json`.
+
+</details>
+
 <details>
 <summary><b>pre.dev CLI</b></summary>
 
-The pre.dev CLI has pre.dev's cloud tools built in, so it only needs the Chrome tools. `setup` adds this to `~/.predev/mcp.json`, and the server uses your pre.dev CLI login:
+In the pre.dev CLI, type `/chrome` (and `/chrome off` to turn it off). The CLI has pre.dev's cloud tools built in, so it only needs the Chrome tools, and the server uses your pre.dev CLI login. `/chrome` and `setup` both add this to `~/.predev/mcp.json`:
 
 ```json
 {
@@ -166,6 +192,8 @@ The pre.dev CLI has pre.dev's cloud tools built in, so it only needs the Chrome
 
 The agent sees the tools as `predev_chrome_open`, `predev_chrome_act` and so on.
 
+From the pre.dev CLI, `predev mcp setup` runs this package's `setup` for your other agents.
+
 </details>
 
 <details>
@@ -303,6 +331,114 @@ Put that entry inside `"mcpServers"` in `~/Library/Application Support/Claude/cl
 
 </details>
 
+<details>
+<summary><b>More agents, by hand</b></summary>
+
+Every entry below is the same server: command `npx`, arguments `-y @predotdev/mcp`.
+
+| Agent | Command, or file and key |
+| --- | --- |
+| GitHub Copilot CLI | `copilot mcp add predev -- npx -y @predotdev/mcp`, or `~/.copilot/mcp-config.json` under `mcpServers` (add `"type": "local", "tools": ["*"]`) |
+| Antigravity (`agy`) | `~/.gemini/config/mcp_config.json` under `mcpServers` |
+| Cline | `cline mcp add predev --yes -- npx -y @predotdev/mcp`, or `~/.cline/data/settings/cline_mcp_settings.json` under `mcpServers` |
+| Kiro | `kiro-cli mcp add --name predev --command "npx -y @predotdev/mcp" --scope global`, or `~/.kiro/settings/mcp.json` |
+| Qwen Code | `qwen mcp add --scope user predev npx -y @predotdev/mcp` |
+| Factory Droid | `droid mcp add predev "npx -y @predotdev/mcp"` |
+| Augment (Auggie) | `auggie mcp add predev --command npx --args "-y @predotdev/mcp"` |
+| Amp | `amp mcp add predev -- npx -y @predotdev/mcp` |
+| OpenClaw | `openclaw mcp set predev '{"command":"npx","args":["-y","@predotdev/mcp"]}'` |
+| Grok Build | `grok mcp add predev -- npx -y @predotdev/mcp` |
+| Devin CLI | `devin mcp add -s user predev -- npx -y @predotdev/mcp` |
+| OpenHands | `openhands mcp add predev --transport stdio npx -- -y @predotdev/mcp` |
+| Kilo Code | `~/.config/kilo/kilo.jsonc` under `mcp`: `"predev": {"type": "local", "command": ["npx", "-y", "@predotdev/mcp"], "enabled": true}` |
+| Kimi Code | `~/.kimi-code/mcp.json` under `mcpServers` |
+| Junie | `~/.junie/mcp/mcp.json` under `mcpServers` |
+| Warp | `~/.warp/.mcp.json` under `mcpServers` |
+| Rovo Dev | `~/.rovodev/mcp.json` under `mcpServers` (add `"transport": "stdio"`) |
+| LM Studio | `~/.lmstudio/mcp.json` under `mcpServers` |
+| JetBrains AI Assistant | Settings → MCP → Import from Claude (after `setup` adds it to Claude Desktop) |
+
+</details>
+
+<details>
+<summary><b>Zed</b></summary>
+
+In `~/.config/zed/settings.json`:
+
+```json
+"context_servers": {
+  "predev": { "command": "npx", "args": ["-y", "@predotdev/mcp"], "env": {} }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Goose</b></summary>
+
+In `~/.config/goose/config.yaml`, under `extensions:`:
+
+```yaml
+  predev:
+    type: stdio
+    name: predev
+    enabled: true
+    cmd: npx
+    args: [-y, "@predotdev/mcp"]
+    envs: {}
+    timeout: 900
+```
+
+For one session only: `goose session --with-extension "npx -y @predotdev/mcp"`.
+
+</details>
+
+<details>
+<summary><b>Continue, Crush and Mistral Vibe</b></summary>
+
+Continue, in `~/.continue/config.yaml`:
+
+```yaml
+mcpServers:
+  - name: predev
+    command: npx
+    args: ["-y", "@predotdev/mcp"]
+```
+
+Crush, one line in `~/.config/crush/crushrc`:
+
+```bash
+mcp add predev --command npx --args -y --args @predotdev/mcp
+```
+
+Mistral Vibe, in `~/.vibe/config.toml`:
+
+```toml
+[[mcp_servers]]
+name = "predev"
+transport = "stdio"
+command = "npx"
+args = ["-y", "@predotdev/mcp"]
+```
+
+</details>
+
+<details>
+<summary><b>Agents without MCP (Aider, scripts, anything with a shell)</b></summary>
+
+Every tool also runs from a shell, so any agent that can run commands can drive your Chrome:
+
+```bash
+npx -y @predotdev/mcp tools                       # list the tools and their arguments
+npx -y @predotdev/mcp call chrome_open '{"profile":"Personal","url":"https://example.com"}'
+npx -y @predotdev/mcp call chrome_snapshot '{"tab":"A1B2C3"}'
+npx -y @predotdev/mcp call chrome_click '{"tab":"A1B2C3","ref":"e4"}'
+```
+
+Text goes to stdout, a screenshot is saved to a file and its path is printed, and the exit code is 1 when the tool failed. Point your agent at this section, or paste `npx -y @predotdev/mcp tools` into its instructions.
+
+</details>
+
 <details>
 <summary><b>Any other MCP client</b></summary>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@predotdev/mcp",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "pre.dev in any coding agent: Browser Agents in the Chrome you already use and in the cloud, plus specs and plans. One command to set up. Free and open source.",
   "type": "module",
   "bin": {

package/src/bridge.mjs

@@ -428,6 +428,10 @@ Commands:
   predev-mcp stop       stop the background daemon (it restarts on the next tool call)
   predev-mcp uninstall  remove it from every agent and delete its files
   predev-mcp            run the MCP server (what your agent launches)
+  predev-mcp tools      list the tools and their arguments
+  predev-mcp call <tool> '<json args>'
+                        run one tool from a shell, for agents without MCP; e.g.
+                        predev-mcp call chrome_open '{"profile":"Default","url":"https://example.com"}'
   predev-mcp --version
 
 Docs: https://docs.pre.dev/browser-agents/local
@@ -495,6 +499,53 @@ if (typeof WebSocket === 'undefined') {
   process.exit(1);
 }
 
+// `tools` and `call`: the same tools from a shell, for agents that run commands but don't speak MCP.
+// Text goes to stdout; an image (a screenshot) is saved to a private temp file and its path printed.
+async function runTools() {
+  const ctx = shimCtx();
+  const tools = [...(await loadTools()).toolList(ctx), ...(CLOUD ? await remote.listTools(ctx).catch(() => []) : [])];
+  for (const tool of tools) {
+    const props = Object.keys(tool.inputSchema?.properties || {});
+    const required = tool.inputSchema?.required || [];
+    console.log(`${tool.name}(${props.map(p => (required.includes(p) ? p : `${p}?`)).join(', ')})`);
+    console.log(`  ${String(tool.description || '').split('\n')[0]}`);
+  }
+}
+
+async function runCall(name, raw) {
+  if (!name) {
+    process.stderr.write(`Usage: predev-mcp call <tool> '<json args>'   (predev-mcp tools lists them)\n`);
+    process.exit(2);
+  }
+  let args = {};
+  try { args = raw ? JSON.parse(raw) : {}; } catch {
+    process.stderr.write('The arguments must be one JSON object, e.g. \'{"tab":"A1B2C3"}\'.\n');
+    process.exit(2);
+  }
+  const ctx = shimCtx();
+  let result;
+  try {
+    if (CLOUD && await remote.isRemote(ctx, name)) {
+      result = ctx.apiKey ? await remote.callTool(ctx, name, args)
+        : { content: [{ type: 'text', text: 'pre.dev tools need a free pre.dev account. Sign in with: npx -y @predotdev/mcp login' }], isError: true };
+    } else {
+      result = await request(await ensureDaemon(), 'POST', '/call', { name, args });
+    }
+  } catch (error) {
+    result = { content: [{ type: 'text', text: `Error: ${error.message}` }], isError: true };
+  }
+  for (const part of result.content || []) {
+    if (part.type === 'text') console.log(part.text);
+    else if (part.type === 'image' && part.data) {
+      const ext = /png/.test(part.mimeType || '') ? 'png' : 'jpg';
+      const file = path.join(os.tmpdir(), `predev-${name}-${Date.now()}.${ext}`);
+      fs.writeFileSync(file, Buffer.from(part.data, 'base64'), { mode: 0o600 });
+      console.log(`Image saved to ${file}`);
+    }
+  }
+  process.exit(result.isError ? 1 : 0);
+}
+
 async function runSetupCommand(name) {
   const { createSetup } = await import(pathToFileURL(path.join(path.dirname(SELF), 'setup.mjs')).href);
   const setup = createSetup({
@@ -509,6 +560,8 @@ const command = process.argv[2] || '';
 if (command === 'daemon') runDaemon();
 else if (['setup', 'install', 'login', 'logout', 'uninstall'].includes(command)) runSetupCommand(command === 'install' ? 'setup' : command);
 else if (command === 'check') runCheck();
+else if (command === 'tools') runTools();
+else if (command === 'call') runCall(process.argv[3], process.argv[4]);
 else if (command === 'stop') runStop();
 else if (command === '--version' || command === '-v') console.log(PKG.version || '0.0.0');
 else if (command === '--help' || command === '-h' || command === 'help') process.stdout.write(HELP);

package/src/setup.mjs

@@ -59,7 +59,8 @@ export function createSetup(ctx) {
   }
 
   const has = bin => spawnSync(process.platform === 'win32' ? 'where' : 'which', [bin], { stdio: 'ignore' }).status === 0;
-  const run = (bin, args) => spawnSync(bin, args, { encoding: 'utf8', timeout: 30000 });
+  // `input` answers a CLI's own confirmation prompts (Hermes asks before it adds or removes a server).
+  const run = (bin, args, input, timeout = 30000) => spawnSync(bin, args, { encoding: 'utf8', timeout, ...(input ? { input } : {}) });
 
   // ------------------------------------------------------------------ sign in
 
@@ -232,6 +233,22 @@ export function createSetup(ctx) {
     try { return Object.fromEntries(JSON.parse(out.stdout).map(server => [server.name, server])); } catch { return {}; }
   };
 
+  // Hermes keeps its servers in config.yaml (under mcp_servers); each entry's block of lines, by name.
+  const hermesHome = process.env.HERMES_HOME || path.join(home, '.hermes');
+  const hermesEntries = () => {
+    let lines;
+    try { lines = fs.readFileSync(path.join(hermesHome, 'config.yaml'), 'utf8').split('\n'); } catch { return {}; }
+    const at = lines.findIndex(line => /^mcp_servers:\s*$/.test(line));
+    const entries = {};
+    let name = null;
+    for (const line of at < 0 ? [] : lines.slice(at + 1)) {
+      if (/^\S/.test(line)) break;
+      const key = /^ {2}([A-Za-z0-9_.-]+):\s*$/.exec(line);
+      if (key) { name = key[1]; entries[name] = ''; } else if (name) entries[name] += `${line}\n`;
+    }
+    return entries;
+  };
+
   function cliAgent(label, bin, entries, remove, add) {
     return {
       label, detect: () => has(bin),
@@ -276,10 +293,56 @@ export function createSetup(ctx) {
         return added;
       }),
     // The pre.dev CLI runs the chrome_* tools only: it has pre.dev's cloud tools built in.
+    // Hermes registers it with its own CLI, which checks the server and asks to enable its tools.
+    cliAgent('Hermes', 'hermes', hermesEntries,
+      name => run('hermes', ['mcp', 'remove', name], 'y\n', 90000),
+      name => {
+        const added = run('hermes', ['mcp', 'add', name, '--command', NODE, '--args', APP_ENTRY], 'Y\nY\n', 90000);
+        // Specs and cloud browser runs need more than Hermes's default tool timeout.
+        if (added.status === 0) run('hermes', ['config', 'set', `mcp_servers.${name}.timeout`, '900']);
+        return added;
+      }),
+    // Pi's built-in MCP (and the pi-mcp-adapter extension) read ~/.pi/agent/mcp.json.
+    jsonAgent('Pi', path.join(process.env.PI_CODING_AGENT_DIR || path.join(home, '.pi/agent'), 'mcp.json'), 'mcpServers',
+      () => ({ ...stdio(), timeout: 900 }),
+      () => exists(process.env.PI_CODING_AGENT_DIR || path.join(home, '.pi')) || has('pi')),
+    // OpenClaw keeps its servers in JSON5; its CLI edits them (set replaces, unset removes) and `show` prints JSON.
+    cliAgent('OpenClaw', 'openclaw', () => {
+      const out = String(run('openclaw', ['mcp', 'show'], null, 60000).stdout || '');
+      try { return JSON.parse(out.slice(out.indexOf('{'))); } catch { return {}; }
+    },
+      name => run('openclaw', ['mcp', 'unset', name], null, 60000),
+      name => run('openclaw', ['mcp', 'set', name, JSON.stringify({ ...stdio(), requestTimeoutMs: 900000 })], null, 60000)),
     jsonAgent('pre.dev CLI', path.join(home, '.predev/mcp.json'), 'mcpServers',
       () => ({ type: 'stdio', ...stdio(), env: { PREDEV_MCP_CLOUD: 'off' } }),
       () => exists(path.join(home, '.predev/bin')) || exists(path.join(home, '.predev/auth.json'))),
     jsonAgent('Cursor', path.join(home, '.cursor/mcp.json'), 'mcpServers', stdio, () => exists(path.join(home, '.cursor'))),
+    // Copilot CLI's file, which VS Code's agent host reads too.
+    jsonAgent('GitHub Copilot CLI', path.join(process.env.COPILOT_HOME || path.join(home, '.copilot'), 'mcp-config.json'), 'mcpServers',
+      () => ({ type: 'local', ...stdio(), tools: ['*'] }), () => exists(process.env.COPILOT_HOME || path.join(home, '.copilot')) || has('copilot')),
+    jsonAgent('Antigravity', path.join(home, '.gemini/config/mcp_config.json'), 'mcpServers', stdio,
+      () => exists(path.join(home, '.gemini/config')) || has('agy')),
+    jsonAgent('Cline', path.join(home, '.cline/data/settings/cline_mcp_settings.json'), 'mcpServers',
+      () => ({ ...stdio(), timeout: 900 }), () => exists(path.join(home, '.cline')) || has('cline')),
+    jsonAgent('Kiro', path.join(home, '.kiro/settings/mcp.json'), 'mcpServers', stdio, () => exists(path.join(home, '.kiro')) || has('kiro-cli')),
+    jsonAgent('Qwen Code', path.join(home, '.qwen/settings.json'), 'mcpServers', () => ({ ...stdio(), timeout: 900000 }),
+      () => exists(path.join(home, '.qwen')) || has('qwen')),
+    jsonAgent('Factory Droid', path.join(home, '.factory/mcp.json'), 'mcpServers', () => ({ type: 'stdio', ...stdio() }),
+      () => exists(path.join(home, '.factory')) || has('droid')),
+    jsonAgent('Augment', path.join(home, '.augment/settings.json'), 'mcpServers', stdio, () => exists(path.join(home, '.augment')) || has('auggie')),
+    jsonAgent('Amp', path.join(home, '.config/amp/settings.json'), 'amp.mcpServers', stdio, () => exists(path.join(home, '.config/amp')) || has('amp')),
+    jsonAgent('Kilo Code', path.join(home, '.config/kilo/kilo.jsonc'), 'mcp', () => ({ type: 'local', command: [NODE, APP_ENTRY], enabled: true }),
+      () => exists(path.join(home, '.config/kilo'))),
+    jsonAgent('Zed', path.join(home, '.config/zed/settings.json'), 'context_servers', () => ({ ...stdio(), env: {} }),
+      () => exists(path.join(home, '.config/zed'))),
+    jsonAgent('Kimi Code', path.join(home, '.kimi-code/mcp.json'), 'mcpServers', () => ({ ...stdio(), toolTimeoutMs: 900000 }),
+      () => exists(path.join(home, '.kimi-code'))),
+    jsonAgent('Junie', path.join(home, '.junie/mcp/mcp.json'), 'mcpServers', stdio, () => exists(path.join(home, '.junie'))),
+    jsonAgent('Warp', path.join(home, '.warp/.mcp.json'), 'mcpServers', stdio, () => exists(path.join(home, '.warp'))),
+    jsonAgent('Rovo Dev', path.join(home, '.rovodev/mcp.json'), 'mcpServers', () => ({ ...stdio(), transport: 'stdio' }),
+      () => exists(path.join(home, '.rovodev'))),
+    jsonAgent('OpenHands', path.join(home, '.openhands/mcp.json'), 'mcpServers', stdio, () => exists(path.join(home, '.openhands'))),
+    jsonAgent('LM Studio', path.join(home, '.lmstudio/mcp.json'), 'mcpServers', stdio, () => exists(path.join(home, '.lmstudio'))),
     jsonAgent('Windsurf', path.join(home, '.codeium/windsurf/mcp_config.json'), 'mcpServers', stdio, () => exists(path.join(home, '.codeium/windsurf'))),
     jsonAgent('Gemini CLI', path.join(home, '.gemini/settings.json'), 'mcpServers', stdio, () => exists(path.join(home, '.gemini')) || has('gemini')),
     jsonAgent('OpenCode', path.join(home, '.config/opencode/opencode.json'), 'mcp',
@@ -288,6 +351,10 @@ export function createSetup(ctx) {
     ...(appSupport ? [
       jsonAgent('VS Code', path.join(appSupport, 'Code/User/mcp.json'), 'servers',
         () => ({ type: 'stdio', ...stdio() }), () => exists(path.join(appSupport, 'Code/User'))),
+      jsonAgent('VS Code Insiders', path.join(appSupport, 'Code - Insiders/User/mcp.json'), 'servers',
+        () => ({ type: 'stdio', ...stdio() }), () => exists(path.join(appSupport, 'Code - Insiders/User'))),
+      jsonAgent('Cline in VS Code', path.join(appSupport, 'Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json'), 'mcpServers',
+        () => ({ ...stdio(), timeout: 900 }), () => exists(path.join(appSupport, 'Code/User/globalStorage/saoudrizwan.claude-dev'))),
       jsonAgent('Claude Desktop', path.join(appSupport, 'Claude/claude_desktop_config.json'), 'mcpServers', stdio,
         () => exists(path.join(appSupport, 'Claude'))),
     ] : []),
@@ -389,7 +456,7 @@ export function createSetup(ctx) {
     step(4, 'Connect to Chrome');
     await connectChrome();
     console.log(failed ? '\nFix the ✗ items above, then run this again (it is safe to repeat).'
-      : `\nAll set.${added.length ? ` Restart ${added.join(', ')} so ${added.length === 1 ? 'it loads' : 'they load'} the new server,` : ''} then ask your agent:\n  "List my Chrome profiles and the tabs I have open."`);
+      : `\nAll set.${added.length ? ` Restart ${added.length > 4 ? `your agents (${added.length} set up above)` : added.join(', ')} so ${added.length === 1 ? 'it loads' : 'they load'} the new server,` : ''} then ask your agent:\n  "List my Chrome profiles and the tabs I have open."`);
     process.exit(failed ? 1 : 0);
   }