claude-remote-cli 0.1.1

package/README.md

@@ -0,0 +1,110 @@
+# claude-remote-cli
+
+Remote web interface for interacting with Claude Code CLI sessions from any device.
+
+## Quick Start
+
+### Install from npm
+
+```bash
+npm install -g claude-remote-cli
+claude-remote-cli
+```
+
+### Or run from source
+
+```bash
+git clone https://github.com/donovan-yohan/claude-remote-cli.git
+cd claude-remote-cli
+npm install
+node server/index.js
+```
+
+On first launch you'll be prompted to set a PIN. Then open `http://localhost:3456` in your browser.
+
+## Prerequisites
+
+- **Node.js 20+**
+- **Claude Code CLI** installed and available in your PATH (or configure `claudeCommand` in config)
+
+## CLI Usage
+
+```
+claude-remote-cli [options]
+
+Options:
+  --port <port>      Override server port (default: 3456)
+  --host <host>      Override bind address (default: 0.0.0.0)
+  --config <path>    Path to config.json
+  --version, -v      Show version
+  --help, -h         Show this help
+```
+
+## Configuration
+
+Config is stored at `~/.config/claude-remote-cli/config.json` (created on first run).
+
+When running from source, it uses `./config.json` in the project root instead.
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `host` | `0.0.0.0` | Bind address |
+| `port` | `3456` | Server port |
+| `cookieTTL` | `24h` | Auth cookie lifetime (e.g. `30m`, `12h`, `7d`) |
+| `rootDirs` | `[]` | Directories containing your git repos (scanned one level deep) |
+| `claudeCommand` | `claude` | Path to the Claude Code CLI binary |
+| `claudeArgs` | `[]` | Extra arguments passed to every Claude session |
+
+Root directories can also be managed from the **Settings** button in the app.
+
+### PIN Management
+
+The PIN hash is stored in config under `pinHash`. To reset:
+
+1. Delete the `pinHash` field from your config file
+2. Restart the server
+3. You'll be prompted to set a new PIN
+
+## Features
+
+- **PIN-protected access** with rate limiting
+- **Worktree isolation** — each session runs in its own Claude Code `--worktree`
+- **Resume sessions** — click inactive worktrees to reconnect
+- **Sidebar filters** — filter by root directory, repo, or text search
+- **Inline rename** — rename sessions with the pencil icon (syncs with Claude Code's `/rename`)
+- **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)
+- **Responsive layout** — works on desktop and mobile with slide-out sidebar
+
+## Architecture
+
+```
+claude-remote-cli/
+├── bin/
+│   └── claude-remote-cli.js  # CLI entry point
+├── server/
+│   ├── index.js       # Express server, REST API routes
+│   ├── sessions.js    # PTY session manager (node-pty)
+│   ├── ws.js          # WebSocket relay (PTY ↔ browser)
+│   ├── auth.js        # PIN hashing, verification, rate limiting
+│   └── config.js      # Config loading/saving
+├── public/
+│   ├── index.html     # Single-page app
+│   ├── app.js         # Frontend logic
+│   ├── style.css      # Styles (dark theme)
+│   └── vendor/        # Self-hosted xterm.js + addon-fit
+├── config.example.json
+└── 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/bin/claude-remote-cli.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+
+// Parse CLI flags
+const args = process.argv.slice(2);
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(`Usage: claude-remote-cli [options]
+
+Options:
+  --port <port>      Override server port (default: 3456)
+  --host <host>      Override bind address (default: 0.0.0.0)
+  --config <path>    Path to config.json (default: ~/.config/claude-remote-cli/config.json)
+  --version, -v      Show version
+  --help, -h         Show this help`);
+  process.exit(0);
+}
+
+if (args.includes('--version') || args.includes('-v')) {
+  const pkg = require('../package.json');
+  console.log(pkg.version);
+  process.exit(0);
+}
+
+function getArg(flag) {
+  const idx = args.indexOf(flag);
+  if (idx === -1 || idx + 1 >= args.length) return undefined;
+  return args[idx + 1];
+}
+
+// Determine config directory
+const configDir = getArg('--config')
+  ? path.dirname(getArg('--config'))
+  : path.join(process.env.HOME || process.env.USERPROFILE || '~', '.config', 'claude-remote-cli');
+
+const configPath = getArg('--config') || path.join(configDir, 'config.json');
+
+// Ensure config directory exists
+if (!fs.existsSync(configDir)) {
+  fs.mkdirSync(configDir, { recursive: true });
+}
+
+// Pass config path and CLI overrides to the server
+process.env.CLAUDE_REMOTE_CONFIG = configPath;
+if (getArg('--port')) process.env.CLAUDE_REMOTE_PORT = getArg('--port');
+if (getArg('--host')) process.env.CLAUDE_REMOTE_HOST = getArg('--host');
+
+require('../server/index.js');

package/config.example.json

@@ -0,0 +1,11 @@
+{
+  "host": "0.0.0.0",
+  "port": 3456,
+  "cookieTTL": "24h",
+  "rootDirs": [
+    "/Users/you/code/work",
+    "/Users/you/code/personal"
+  ],
+  "claudeCommand": "claude",
+  "claudeArgs": []
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "claude-remote-cli",
+  "version": "0.1.1",
+  "description": "Remote web interface for Claude Code CLI sessions",
+  "main": "server/index.js",
+  "bin": {
+    "claude-remote-cli": "bin/claude-remote-cli.js"
+  },
+  "files": [
+    "bin/",
+    "server/",
+    "public/",
+    "config.example.json"
+  ],
+  "scripts": {
+    "start": "node server/index.js",
+    "test": "node --test test/*.test.js",
+    "postinstall": "chmod +x node_modules/node-pty/prebuilds/darwin-arm64/spawn-helper 2>/dev/null || true"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "remote",
+    "cli",
+    "terminal",
+    "mobile",
+    "web",
+    "pty"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/donovan-yohan/claude-remote-cli.git"
+  },
+  "license": "MIT",
+  "author": "Donovan Yohan",
+  "dependencies": {
+    "bcrypt": "^5.1.1",
+    "cookie-parser": "^1.4.7",
+    "express": "^4.21.0",
+    "node-pty": "^1.0.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.2",
+    "playwright": "^1.58.2"
+  }
+}