anyagent-bridge 0.8.0 → 0.8.1

package/README.md

@@ -6,6 +6,8 @@ Control your local computer's terminal — and **any** CLI AI coding agent you'v
 
 ## Quick start
 
+First install **Node.js 18+** (the LTS build from <https://nodejs.org>) — `npx` needs it. Then:
+
 ```bash
 # New here? A guided, first-timer setup (checks prerequisites, helps you go mobile):
 npx anyagent-bridge setup

package/bin/setup.js

@@ -18,6 +18,7 @@ const fs = require('fs');
 const os = require('os');
 const crypto = require('crypto');
 const readline = require('readline');
+const { spawnSync } = require('child_process');
 const pkg = require('../package.json');
 
 // ── tiny ANSI helpers (no dependency) ─────────────────────────────────────────
@@ -114,8 +115,17 @@ async function confirm(question, def = true) {
   if (!agents.some((a) => a.found)) {
     out();
     out(yellow('  No AI agent CLI was found. The bridge still runs (you get a plain shell),'));
-    out(yellow('  but to launch an agent install one first, e.g. Claude Code:'));
-    out('    ' + cyan('npm install -g @anthropic-ai/claude-code') + dim('   then run `claude` once to log in.'));
+    out(yellow('  but to launch an agent you need one installed.'));
+    const wantClaude = await confirm('  Install Claude Code now (npm i -g @anthropic-ai/claude-code)?', false);
+    if (wantClaude) {
+      out(dim('  Installing via npm — this may take a minute…'));
+      const r = spawnSync('npm', ['install', '-g', '@anthropic-ai/claude-code'],
+        { stdio: 'inherit', shell: process.platform === 'win32' });
+      if (r.status === 0) out(green('  ✓ Installed. Run `claude` once in a terminal to log in, then it shows up here.'));
+      else out(yellow('  Install didn\'t finish — do it manually: ') + cyan('npm install -g @anthropic-ai/claude-code'));
+    } else {
+      out('  Install one yourself, e.g.: ' + cyan('npm install -g @anthropic-ai/claude-code') + dim('   then run `claude` once to log in.'));
+    }
     out(dim('  (Any CLI works — register it under "agents" in config.json.)'));
   }
 
@@ -145,6 +155,7 @@ async function confirm(question, def = true) {
       : `Find this computer's local IP (e.g. ${dim('System Settings → Network')}), then visit ${cyan(`http://<that-ip>:${port}/`)} on the other device.`);
     nextSteps.push(`${yellow('Heads up:')} on your Wi-Fi the access token is the only lock. Keep it private; only people on your network can even reach the page.`);
     nextSteps.push(`Easiest on a phone: open the page on this computer, click ${bold('"Connect a device" → Phone')}, and scan the QR.`);
+    if (process.platform === 'win32') nextSteps.push(`${yellow('Windows:')} the first time another device connects, Windows pops a Firewall prompt — click ${bold('Allow')} (at least Private networks) or the page won't load.`);
   } else {
     host = '127.0.0.1'; // the tunnel reaches in; we don't bind to the network directly
     out();
@@ -160,9 +171,15 @@ async function confirm(question, def = true) {
       tunnelProvider = prov.key === '2' ? 'cloudflare-quick' : 'devtunnel';
       const cli = tunnelProvider === 'cloudflare-quick' ? 'cloudflared' : 'devtunnel';
       if (!onPath(cli)) {
-        out(yellow(`   The "${cli}" command isn't installed yet.`));
-        out(`   Install it, then re-run setup. Docs: ${cyan('docs/INSTALL.md')} (Remote access).`);
-        out(dim('   Continuing anyway — the server will fall back to localhost-only if the tunnel cannot start.'));
+        out(yellow(`   The "${cli}" command isn't installed yet — install it, then re-run setup:`));
+        if (cli === 'cloudflared') {
+          if (process.platform === 'darwin') out('     ' + cyan('brew install cloudflared'));
+          else if (process.platform === 'win32') out('     ' + cyan('winget install --id Cloudflare.cloudflared') + dim('   (or grab it from github.com/cloudflare/cloudflared/releases)'));
+          else out('     ' + cyan('https://pkg.cloudflare.com') + dim('   (apt/yum) or github.com/cloudflare/cloudflared/releases'));
+        } else {
+          out('     ' + cyan('https://aka.ms/devtunnels/download') + dim('   then run `devtunnel user login` once'));
+        }
+        out(dim('   Continuing anyway — the server falls back to localhost-only if the tunnel cannot start.'));
       }
       nextSteps.push(`When the tunnel connects, its public ${bold('https://…')} URL prints in the banner below and shows in the UI.`);
       nextSteps.push(`Open that URL on your phone, or use ${bold('"Connect a device" → Phone')} in the UI to scan a QR.`);

package/docs/GETTING-STARTED.md

@@ -103,6 +103,13 @@ so you never paste keys into the chat or hand-edit dotfiles.
   tunnel at all — use the "same Wi-Fi" address instead.
 - **Lost the token** — it's printed in the terminal banner; scroll up, or stop and
   re-run. You can also pin your own with `--token`.
+- **Windows: another device can't reach it on Wi-Fi** — the first inbound connection
+  triggers a Windows Firewall prompt; click **Allow** (at least for Private networks).
+  If you dismissed it, allow `node` in Windows Defender Firewall settings.
+- **Windows: a red `'...cmd_autorun.bat' is not recognized…` line at the top of the
+  terminal** — that's not an anyagent-bridge error. It's a stale `cmd.exe` AutoRun
+  registry key on your machine (`HKCU\Software\Microsoft\Command Processor\AutoRun`);
+  the shell still works. Clear that key if you want the line gone.
 
 ## Where to go next
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anyagent-bridge",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Control your local terminal and any CLI AI coding agent from a browser, anywhere.",
   "license": "MIT",
   "author": "elon-choo",

package/server/index.js

@@ -744,7 +744,10 @@ class TerminalSession {
       console.warn(`[Session ${this.sessionId}] startAgent: invalid agent`);
       return;
     }
-    this.write(`${agent.command}\n`);
+    // Submit with CR, not LF: a real Enter key sends "\r" to a PTY. On Unix the line
+    // discipline maps CR→NL (ICRNL) so the command still runs; on Windows ConPTY,
+    // cmd.exe only executes a line ended with "\r" ("\n" types it but never runs it).
+    this.write(`${agent.command}\r`);
     this.activeAgentId = agent.id;
     console.log(`[Session ${this.sessionId}] Started agent '${agent.id}' (${agent.command})`);
   }
@@ -752,7 +755,7 @@ class TerminalSession {
   /** Send a line of text to whatever is currently running in the PTY. */
   sendToAgent(text) {
     if (text == null) return;
-    this.write(String(text) + '\n');
+    this.write(String(text) + '\r'); // CR submits on both Unix PTYs and Windows ConPTY (see startAgent)
   }
 
   destroy() {

package/test/stage4-smoke.js

@@ -132,7 +132,9 @@ t('buildDockerArgs has run --rm -it, name, mount, limits, image, shell', () => {
   const j = args.join(' ');
   assert(args[0] === 'run' && args.includes('--rm') && args.includes('-it'), j);
   assert(j.includes('--name aab-x-sess-1-ab'), j);
-  assert(j.includes('-v /tmp/proj:/workspace') && j.includes('-w /workspace'), j);
+  // OS-aware: buildDockerArgs maps the host path via dockerMountPath (e.g. on Windows
+  // C:\tmp\proj → //c/tmp/proj), so derive the expected mount the same way.
+  assert(j.includes('-v ' + sandbox.dockerMountPath('/tmp/proj') + ':/workspace') && j.includes('-w /workspace'), j);
   assert(j.includes('--network bridge') && j.includes('--memory 2g') && j.includes('--pids-limit 512'), j);
   assert(j.includes('--security-opt no-new-privileges'), j);
   assert(args[args.length - 2] === 'demo:latest' || args.includes('demo:latest'), j);