claude-remote-cli 1.7.0 → 1.7.2

package/README.md

@@ -17,14 +17,14 @@ claude-remote-cli
 git clone https://github.com/donovan-yohan/claude-remote-cli.git
 cd claude-remote-cli
 npm install
-node server/index.js
+npm start
 ```
 
 On first launch you'll be prompted to set a PIN. Then open `http://localhost:3456` in your browser.
 
 ## Prerequisites
 
-- **Node.js 20+**
+- **Node.js 24+**
 - **Claude Code CLI** installed and available in your PATH (or configure `claudeCommand` in config)
 
 ## Platform Support
@@ -38,6 +38,7 @@ Usage: claude-remote-cli [options]
        claude-remote-cli <command>
 
 Commands:
+  update             Update to the latest version from npm
   install            Install as a background service (survives reboot)
   uninstall          Stop and remove the background service
   status             Show whether the service is running
@@ -106,32 +107,45 @@ The PIN hash is stored in config under `pinHash`. To reset:
 
 - **PIN-protected access** with rate limiting
 - **Worktree isolation** — each session runs in its own Claude Code `--worktree`
-- **Resume sessions** — click inactive worktrees to reconnect
+- **Resume sessions** — click inactive worktrees to reconnect with `--continue`
+- **Persistent session names** — display names and timestamps survive server restarts
+- **Clipboard image paste** — paste screenshots directly into remote terminal sessions (macOS clipboard + xclip on Linux)
+- **Yolo mode** — skip permission prompts with `--dangerously-skip-permissions` (per-session checkbox or context menu)
+- **Worktree cleanup** — delete inactive worktrees from the context menu (removes worktree, prunes refs, deletes branch)
 - **Sidebar filters** — filter by root directory, repo, or text search
-- **Inline rename** — rename sessions with the pencil icon (syncs with Claude Code's `/rename`)
+- **Inline rename** — rename sessions with the pencil icon
 - **Scrollback buffer** — reconnect to a session and see prior output
-- **Touch toolbar** — mobile-friendly buttons for special keys (arrows, Enter, Escape, Ctrl+C, Tab, y/n)
+- **Touch toolbar** — mobile-friendly buttons for special keys (hidden on desktop)
 - **Responsive layout** — works on desktop and mobile with slide-out sidebar
 - **Real-time updates** — worktree changes on disk are pushed to the browser instantly via WebSocket
+- **Update notifications** — toast notification when a new version is available, with one-click update
+- **CLI self-update** — `claude-remote-cli update` to update from npm
 
 ## Architecture
 
+TypeScript + ESM backend compiled to `dist/`. Vanilla JS frontend (no build step).
+
 ```
 claude-remote-cli/
 ├── bin/
-│   └── claude-remote-cli.js  # CLI entry point
+│   └── claude-remote-cli.ts  # CLI entry point
 ├── server/
-│   ├── index.js       # Express server, REST API routes
-│   ├── sessions.js    # PTY session manager (node-pty)
-│   ├── ws.js          # WebSocket relay (PTY ↔ browser)
-│   ├── watcher.js     # File watcher for .claude/worktrees/ changes
-│   ├── auth.js        # PIN hashing, verification, rate limiting
-│   └── config.js      # Config loading/saving
+│   ├── index.ts        # Express server, REST API routes
+│   ├── sessions.ts     # PTY session manager (node-pty)
+│   ├── ws.ts           # WebSocket relay (PTY ↔ browser)
+│   ├── watcher.ts      # File watcher for .claude/worktrees/ changes
+│   ├── auth.ts         # PIN hashing, verification, rate limiting
+│   ├── config.ts       # Config loading/saving, worktree metadata
+│   ├── clipboard.ts    # System clipboard operations (image paste)
+│   ├── service.ts      # Background service management (launchd/systemd)
+│   └── types.ts        # Shared TypeScript interfaces
 ├── public/
-│   ├── index.html     # Single-page app
-│   ├── app.js         # Frontend logic
-│   ├── style.css      # Styles (dark theme)
-│   └── vendor/        # Self-hosted xterm.js + addon-fit
+│   ├── index.html      # Single-page app
+│   ├── app.js          # Frontend logic (ES5, no build step)
+│   ├── style.css       # Styles (dark theme)
+│   └── vendor/         # Self-hosted xterm.js + addon-fit
+├── test/               # Unit tests (node:test)
+├── dist/               # Compiled output (gitignored)
 ├── config.example.json
 └── package.json
 ```

package/dist/server/index.js

@@ -332,21 +332,26 @@ async function main() {
         let args;
         let cwd;
         let worktreeName;
+        let sessionRepoPath;
         if (worktreePath) {
             // Resume existing worktree — run claude --continue inside the worktree directory
             args = ['--continue', ...baseArgs];
             cwd = worktreePath;
+            sessionRepoPath = worktreePath;
             worktreeName = worktreePath.split('/').pop() || '';
         }
         else {
-            // New worktree
+            // New worktree — PTY spawns in the repo root (so `claude --worktree X` works),
+            // but repoPath points to the expected worktree dir for identity/metadata matching
             worktreeName = 'mobile-' + name + '-' + Date.now().toString(36);
             args = ['--worktree', worktreeName, ...baseArgs];
             cwd = repoPath;
+            sessionRepoPath = path.join(repoPath, '.claude', 'worktrees', worktreeName);
         }
         const session = sessions.create({
             repoName: name,
-            repoPath: cwd,
+            repoPath: sessionRepoPath,
+            cwd,
             root,
             worktreeName,
             displayName: worktreeName,

package/dist/server/sessions.js

@@ -6,7 +6,7 @@ import path from 'node:path';
 import { readMeta, writeMeta } from './config.js';
 // In-memory registry: id -> Session
 const sessions = new Map();
-function create({ repoName, repoPath, root, worktreeName, displayName, command, args = [], cols = 80, rows = 24, configPath }) {
+function create({ repoName, repoPath, cwd, root, worktreeName, displayName, command, args = [], cols = 80, rows = 24, configPath }) {
     const id = crypto.randomBytes(8).toString('hex');
     const createdAt = new Date().toISOString();
     // Strip CLAUDECODE env var to allow spawning claude inside a claude-managed server
@@ -16,7 +16,7 @@ function create({ repoName, repoPath, root, worktreeName, displayName, command,
         name: 'xterm-256color',
         cols,
         rows,
-        cwd: repoPath,
+        cwd: cwd || repoPath,
         env,
     });
     // Scrollback buffer: stores all PTY output so we can replay on WebSocket (re)connect

package/package.json

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

package/public/app.js

@@ -155,6 +155,60 @@
       }
     });
 
+    // On Windows/Linux, Ctrl+V is the paste shortcut but xterm.js intercepts it
+    // internally without firing a native paste event, so our image paste handler
+    // on terminalContainer never runs. Intercept Ctrl+V here to check for images.
+    // On macOS, Ctrl+V sends a raw \x16 to the terminal (used by vim etc.), so
+    // we only intercept on non-Mac platforms.
+    var isMac = /Mac|iPhone|iPad|iPod/.test(navigator.platform || '');
+    if (!isMac) {
+      term.attachCustomKeyEventHandler(function (e) {
+        if (e.type === 'keydown' && e.ctrlKey && !e.shiftKey && !e.altKey && !e.metaKey &&
+            (e.key === 'v' || e.key === 'V')) {
+          if (navigator.clipboard && navigator.clipboard.read) {
+            navigator.clipboard.read().then(function (clipboardItems) {
+              var imageBlob = null;
+              var imageType = null;
+
+              for (var i = 0; i < clipboardItems.length; i++) {
+                var types = clipboardItems[i].types;
+                for (var j = 0; j < types.length; j++) {
+                  if (types[j].indexOf('image/') === 0) {
+                    imageType = types[j];
+                    imageBlob = clipboardItems[i];
+                    break;
+                  }
+                }
+                if (imageBlob) break;
+              }
+
+              if (imageBlob) {
+                imageBlob.getType(imageType).then(function (blob) {
+                  uploadImage(blob, imageType);
+                });
+              } else {
+                navigator.clipboard.readText().then(function (text) {
+                  if (text) term.paste(text);
+                });
+              }
+            }).catch(function () {
+              // Clipboard read failed (permission denied, etc.) — fall back to text.
+              // If readText also fails, paste is lost for this keypress; this only
+              // happens when clipboard permission is fully denied, which is rare
+              // for user-gesture-triggered reads on HTTPS origins.
+              if (navigator.clipboard.readText) {
+                navigator.clipboard.readText().then(function (text) {
+                  if (text) term.paste(text);
+                }).catch(function () {});
+              }
+            });
+            return false; // Prevent xterm from handling Ctrl+V
+          }
+        }
+        return true; // Let xterm handle all other keys
+      });
+    }
+
     var resizeObserver = new ResizeObserver(function () {
       fitAddon.fit();
       sendResize();