claude-remote-cli 1.9.1 → 1.9.2

package/README.md

@@ -2,30 +2,66 @@
 
 Remote web interface for interacting with Claude Code CLI sessions from any device.
 
-## Quick Start
+## Getting Started
 
-### Install from npm
+### 1. Install
 
 ```bash
 npm install -g claude-remote-cli
+```
+
+Requires **Node.js 24+** and **[Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)** installed and available in your PATH.
+
+### 2. Start the server
+
+```bash
 claude-remote-cli
 ```
 
-### Or run from source
+On first launch you'll be prompted to set a PIN. This PIN protects access to your Claude sessions.
+
+Open `http://localhost:3456` in your browser and enter your PIN.
+
+### 3. Add your project directories
+
+Click **Settings** in the app to add root directories — these are parent folders that contain your git repos (scanned one level deep).
+
+You can also edit `~/.config/claude-remote-cli/config.json` directly:
+
+```json
+{
+  "rootDirs": ["/home/you/projects", "/home/you/work"]
+}
+```
+
+### 4. Run as a background service (recommended)
+
+To keep the server running after you close your terminal and auto-start on login:
 
 ```bash
-git clone https://github.com/donovan-yohan/claude-remote-cli.git
-cd claude-remote-cli
-npm install
-npm start
+claude-remote-cli --bg
 ```
 
-On first launch you'll be prompted to set a PIN. Then open `http://localhost:3456` in your browser.
+This installs a persistent service (launchd on macOS, systemd on Linux) that restarts on crash. See [Background Service](#background-service) for more options.
+
+### 5. Access from your phone with Tailscale
+
+claude-remote-cli binds to `0.0.0.0` by default, but you should **not** expose it to the public internet. Use [Tailscale](https://tailscale.com/) to create a private encrypted network between your devices.
+
+1. **Install Tailscale** on your computer (the one running claude-remote-cli) and on your phone/tablet
+   - macOS: `brew install tailscale` or download from [tailscale.com/download](https://tailscale.com/download)
+   - Linux: follow the [install guide](https://tailscale.com/download/linux)
+   - iOS/Android: install the Tailscale app from your app store
+
+2. **Sign in** to the same Tailscale account on both devices
 
-## Prerequisites
+3. **Find your computer's Tailscale IP** — run `tailscale ip` on your computer, or check the Tailscale admin console. It will look like `100.x.y.z`.
 
-- **Node.js 24+**
-- **Claude Code CLI** installed and available in your PATH (or configure `claudeCommand` in config)
+4. **Open the app** on your phone at `http://100.x.y.z:3456`
+
+That's it. Your traffic is encrypted end-to-end via WireGuard, no ports are exposed to the internet, and only devices on your Tailscale network can reach the server.
+
+> **Alternatives:** You can also use [Cloudflare Tunnel](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/) (`cloudflared tunnel --url http://localhost:3456`) or [ngrok](https://ngrok.com/) (`ngrok http 3456`), but these expose your server to the public internet and rely on the PIN as your only layer of defense. Tailscale keeps everything private.
 
 ## Platform Support
 
@@ -150,14 +186,6 @@ claude-remote-cli/
 └── package.json
 ```
 
-## Remote Access
-
-To access from your phone or another device, expose the server via a tunnel or VPN:
-
-- **Tailscale** (recommended): Install on both devices, access via Tailscale IP
-- **Cloudflare Tunnel**: `cloudflared tunnel --url http://localhost:3456`
-- **ngrok**: `ngrok http 3456`
-
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-remote-cli",
-  "version": "1.9.1",
+  "version": "1.9.2",
   "description": "Remote web interface for Claude Code CLI sessions",
   "type": "module",
   "main": "dist/server/index.js",

package/public/app.js

@@ -249,7 +249,7 @@
     }
 
     terminalScrollbarThumb.style.display = 'block';
-    var thumbHeight = Math.max(20, (term.rows / totalLines) * trackHeight);
+    var thumbHeight = Math.max(isMobileDevice ? 44 : 20, (term.rows / totalLines) * trackHeight);
     var thumbTop = (viewportTop / (totalLines - term.rows)) * (trackHeight - thumbHeight);
 
     terminalScrollbarThumb.style.height = thumbHeight + 'px';
@@ -262,7 +262,7 @@
     var totalLines = buf.baseY + term.rows;
     if (totalLines <= term.rows) return;
 
-    var thumbHeight = Math.max(20, (term.rows / totalLines) * terminalScrollbar.clientHeight);
+    var thumbHeight = Math.max(isMobileDevice ? 44 : 20, (term.rows / totalLines) * terminalScrollbar.clientHeight);
     var trackUsable = terminalScrollbar.clientHeight - thumbHeight;
     var relativeY = clientY - rect.top - thumbHeight / 2;
     var ratio = Math.max(0, Math.min(1, relativeY / trackUsable));
@@ -287,7 +287,7 @@
       var totalLines = buf.baseY + term.rows;
       if (totalLines <= term.rows) return;
 
-      var thumbHeight = Math.max(20, (term.rows / totalLines) * terminalScrollbar.clientHeight);
+      var thumbHeight = Math.max(isMobileDevice ? 44 : 20, (term.rows / totalLines) * terminalScrollbar.clientHeight);
       var trackUsable = terminalScrollbar.clientHeight - thumbHeight;
       var newTop = Math.max(0, Math.min(trackUsable, scrollbarDragStartTop + deltaY));
       var ratio = newTop / trackUsable;
@@ -1108,12 +1108,22 @@
     var text = btn.dataset.text;
     var key = btn.dataset.key;
 
+    // Flush composed text before sending Enter so pending input isn't lost
+    if (key === '\r' && mobileInput.flushComposedText) {
+      mobileInput.flushComposedText();
+    }
+
     if (text !== undefined) {
       ws.send(text);
     } else if (key !== undefined) {
       ws.send(key);
     }
 
+    // Clear input after Enter to reset state
+    if (key === '\r' && mobileInput.clearInput) {
+      mobileInput.clearInput();
+    }
+
     // Re-focus the mobile input to keep keyboard open
     if (isMobileDevice) {
       mobileInput.focus();
@@ -1342,12 +1352,12 @@
     });
 
     mobileInput.addEventListener('compositionend', function () {
+      isComposing = false;
       if (ws && ws.readyState === WebSocket.OPEN) {
         var currentValue = mobileInput.value;
         sendInputDiff(currentValue);
         lastInputValue = currentValue;
       }
-      setTimeout(function () { isComposing = false; }, 0);
     });
 
     mobileInput.addEventListener('blur', function () {
@@ -1362,6 +1372,25 @@
       lastInputValue = '';
     });
 
+    // Flush any pending composed text to the terminal.
+    // Safe to call even if compositionend already ran: sendInputDiff
+    // is a no-op when lastInputValue === mobileInput.value.
+    function flushComposedText() {
+      isComposing = false;
+      if (ws && ws.readyState === WebSocket.OPEN) {
+        var currentValue = mobileInput.value;
+        sendInputDiff(currentValue);
+        lastInputValue = currentValue;
+      }
+    }
+    function clearInput() {
+      mobileInput.value = '';
+      lastInputValue = '';
+    }
+    // Expose for toolbar handler
+    mobileInput.flushComposedText = flushComposedText;
+    mobileInput.clearInput = clearInput;
+
     // Handle text input with autocorrect
     var clearTimer = null;
     mobileInput.addEventListener('input', function () {
@@ -1389,6 +1418,7 @@
 
       switch (e.key) {
         case 'Enter':
+          flushComposedText();
           ws.send('\r');
           mobileInput.value = '';
           lastInputValue = '';

package/public/index.html

@@ -6,7 +6,7 @@
   <title>Claude Remote CLI</title>
   <link rel="manifest" href="/manifest.json" />
   <link rel="icon" href="/icon.svg" type="image/svg+xml" />
-  <link rel="apple-touch-icon" href="/icon.svg" />
+  <link rel="apple-touch-icon" href="/icon-192.png" />
   <meta name="mobile-web-app-capable" content="yes" />
   <meta name="apple-mobile-web-app-capable" content="yes" />
   <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
@@ -184,5 +184,6 @@
   <script src="/vendor/xterm.js"></script>
   <script src="/vendor/addon-fit.js"></script>
   <script src="/app.js"></script>
+  <script>if ('serviceWorker' in navigator) navigator.serviceWorker.register('/sw.js');</script>
 </body>
 </html>

package/public/manifest.json

@@ -6,11 +6,20 @@
   "background_color": "#1a1a1a",
   "theme_color": "#1a1a1a",
   "icons": [
+    {
+      "src": "/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    },
     {
       "src": "/icon.svg",
       "sizes": "any",
-      "type": "image/svg+xml",
-      "purpose": "any"
+      "type": "image/svg+xml"
     }
   ]
 }

package/public/style.css

@@ -1089,6 +1089,16 @@ dialog#delete-worktree-dialog h2 {
 
   #terminal-scrollbar {
     display: block;
+    width: 24px;
+    right: 0;
+  }
+
+  #terminal-scrollbar-thumb {
+    width: 24px;
+    min-height: 44px;
+    border-radius: 12px;
+    background: var(--text-muted);
+    opacity: 0.5;
   }
 }
 

package/public/sw.js

@@ -0,0 +1,5 @@
+// Minimal service worker for PWA install prompt support.
+// Does not cache — all requests pass through to the network.
+self.addEventListener('fetch', function (event) {
+  event.respondWith(fetch(event.request));
+});