claude-code-remote-pilot 0.4.2 → 0.4.4

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.4.4 — 2026-05-06
+
+### Added
+- Press `w` in watch mode to open (or reuse) the web dashboard in the browser. Starts the server on `127.0.0.1:3742` if not already running. Shown in the watch footer: `w: web ui`.
+
+---
+
+## 0.4.3 — 2026-05-06
+
+### Added
+- `web [port] [host]` — web dashboard now accepts an optional bind host.
+  - `web` → `127.0.0.1:3742` (local only, default)
+  - `web 3742 0.0.0.0` → bind to all interfaces (accessible from other devices on the network)
+  - `web 8080 192.168.1.10` → bind to a specific interface
+
+---
+
 ## 0.4.2 — 2026-05-06
 
 ### Fixed

package/README.md

@@ -104,7 +104,7 @@ sudo apt update && sudo apt install tmux
 | `spawn <path> [name]` | Start Claude at a path. Name defaults to the directory name. |
 | `list` | One-shot status of all sessions. |
 | `watch` | Live dashboard with offline session history. Press a number to select, `q` to exit. |
-| `web [port]` | Start the web dashboard at `http://127.0.0.1:3742` (or given port). Opens browser automatically. |
+| `web [port] [host]` | Start the web dashboard. Defaults to `127.0.0.1:3742`. Use `0.0.0.0` to expose on the network. |
 | `attach <name>` | Open a tmux session in the current terminal. |
 | `kill <name>` | Stop a session. |
 | `help` | Show command reference. |
@@ -129,7 +129,14 @@ The dashboard shows all sessions (live and offline), lets you:
 - Kill sessions
 - See a live activity log of status transitions
 
-The server binds to `127.0.0.1` only — not reachable from other machines. Use `web <port>` to use a custom port.
+By default the server binds to `127.0.0.1` — local only. To access from other devices on your network:
+
+```
+claude-pilot> web 3742 0.0.0.0
+  ✓ Web dashboard started at http://0.0.0.0:3742
+```
+
+You can also bind to a specific interface IP: `web 3742 192.168.1.10`.
 
 ---
 

package/bin/claude-pilot.js

@@ -170,7 +170,7 @@ function renderWatchTable(allSessions, selectedIdx) {
       footer = `  [t] terminal   [k] kill   Esc: back`;
     }
   } else {
-    footer = `  [1-${Math.min(allSessions.length, 9)}]: select session   q: exit watch`;
+    footer = `  [1-${Math.min(allSessions.length, 9)}]: select session   w: web ui   q: exit watch`;
   }
 
   return ['\n', '  Claude Code Remote Pilot', bar, header, bar, ...rows, bar, footer, ''].join('\n');
@@ -222,6 +222,18 @@ function startWatch(manager, rl) {
 
     if (selectedIdx < 0) {
       if (str === 'q' || str === 'Q') { exitWatch(); return; }
+      if (str === 'w' || str === 'W') {
+        let webServer = manager._webServer;
+        if (!webServer) {
+          webServer = new WebServer(manager, 3742, '127.0.0.1');
+          manager._webServer = webServer;
+          webServer.start();
+        }
+        const url = `http://${webServer.host}:${webServer.port}`;
+        const opener = process.platform === 'darwin' ? 'open' : 'xdg-open';
+        spawn(opener, [url], { stdio: 'ignore', detached: true }).unref();
+        return;
+      }
       const n = parseInt(str);
       if (!isNaN(n) && n >= 1 && n <= Math.min(allSessions.length, 9)) {
         selectedIdx = n - 1;
@@ -319,7 +331,7 @@ const HELP = `
   spawn <path> [name]   Start Claude at path (name defaults to dir name)
   list                  Show all sessions
   watch                 Live session monitor  (q to exit)
-  web [port]            Start web dashboard  (default port 3742)
+  web [port] [host]     Start web dashboard  (default: 3742 127.0.0.1)
   attach <name>         Open tmux session in this terminal
   kill <name>           Stop a session
   resume [message]      Show or set the message sent after a limit resets
@@ -432,15 +444,16 @@ ${HELP}`);
         }
         case 'web': {
           const port = parseInt(args[0]) || 3742;
+          const host = args[1] || '127.0.0.1';
           let webServer = manager._webServer;
           if (webServer) {
-            console.log(`  Web dashboard already running at http://127.0.0.1:${webServer.port}`);
+            console.log(`  Web dashboard already running at http://${webServer.host}:${webServer.port}`);
             break;
           }
-          webServer = new WebServer(manager, port);
+          webServer = new WebServer(manager, port, host);
           manager._webServer = webServer;
           webServer.start();
-          const url = `http://127.0.0.1:${port}`;
+          const url = `http://${host}:${port}`;
           console.log(`  ✓ Web dashboard started at ${url}`);
           const opener = process.platform === 'darwin' ? 'open' : 'xdg-open';
           spawn(opener, [url], { stdio: 'ignore', detached: true }).unref();

package/lib/WebServer.js

@@ -8,9 +8,10 @@ const config = require('./config');
 const STRIP_ANSI = /\x1b\[[0-9;]*[mGKHFABCDJsuhl]|\x1b[()][AB012]/g;
 
 class WebServer {
-  constructor(manager, port = 3742) {
+  constructor(manager, port = 3742, host = '127.0.0.1') {
     this.manager = manager;
     this.port = port;
+    this.host = host;
     this.startedAt = new Date();
     this.server = null;
     this._clients = new Set();
@@ -160,7 +161,7 @@ class WebServer {
     });
 
     this._broadcastInterval = setInterval(() => this._broadcast(), 3000);
-    this.server.listen(this.port, '127.0.0.1');
+    this.server.listen(this.port, this.host);
     return this.port;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-remote-pilot",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Interactive Claude Code supervisor — spawn and monitor multiple Claude sessions from a single terminal.",
   "type": "commonjs",
   "bin": {