@remotego/remotego 1.0.1 → 1.1.0

package/README.md

@@ -5,7 +5,7 @@ Expose any CLI tool as a public web terminal via tunnel.
 ## Install
 
 ```bash
-npm install -g @zhanju/remotego
+npm install -g @remotego/remotego
 ```
 
 ## Usage
@@ -20,6 +20,7 @@ remotego <command> [command-args...] [options]
 |--------|-------------|---------|
 | `--port <port>` | Port to listen on | `7681` |
 | `--cwd <dir>` | Working directory for the command | Current directory |
+| `--domain <domain>` | Custom domain for localhost.run tunnel | Random subdomain |
 | `--help, -h` | Show help | |
 
 ### Examples
@@ -40,6 +41,9 @@ remotego vim
 # Custom port
 remotego --port 9000 node
 
+# Custom tunnel domain
+remotego --domain myterm.localhost.run bash
+
 # Pass flags to the command (use -- to separate)
 remotego -- git log --oneline
 ```

package/bin/remotego.js

@@ -29,6 +29,8 @@ function parseArgs(argv) {
       flags.port = argv[++i];
     } else if (arg === '--cwd' && argv[i + 1]) {
       flags.cwd = argv[++i];
+    } else if (arg === '--domain' && argv[i + 1]) {
+      flags.domain = argv[++i];
     } else if (arg === '--help' || arg === '-h') {
       printHelp();
       process.exit(0);
@@ -62,17 +64,19 @@ Usage:
   remotego claude
 
 Options:
-  --port <port>   Port to listen on (default: 7681)
-  --cwd <dir>     Working directory for the command (default: current dir)
-  --help, -h      Show this help message
+  --port <port>       Port to listen on (default: 7681)
+  --cwd <dir>         Working directory for the command (default: current dir)
+  --domain <domain>   Custom domain for localhost.run tunnel (default: random)
+  --help, -h          Show this help message
 
 Examples:
-  remotego claude              # Mirror Claude Code
-  remotego vim                 # Mirror vim editor
-  remotego bash                # Mirror a bash shell
-  remotego python3 -i          # Mirror Python REPL
-  remotego --port 9000 node    # Mirror Node.js REPL on port 9000
-  remotego -- --flagged-arg    # Use -- to separate flags from command args
+  remotego claude                        # Mirror Claude Code
+  remotego vim                           # Mirror vim editor
+  remotego bash                          # Mirror a bash shell
+  remotego python3 -i                    # Mirror Python REPL
+  remotego --port 9000 node              # Mirror Node.js REPL on port 9000
+  remotego --domain myterm.localhost.run bash  # Custom tunnel domain
+  remotego -- --flagged-arg              # Use -- to separate flags from command args
 `);
 }
 
@@ -98,6 +102,10 @@ if (flags.port) {
   env.PORT = flags.port;
 }
 
+if (flags.domain) {
+  env.TUNNEL_DOMAIN = flags.domain;
+}
+
 // Install server dependencies if needed
 import { existsSync } from 'fs';
 if (!existsSync(resolve(serverDir, 'node_modules'))) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remotego/remotego",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Expose any CLI tool as a public web terminal via tunnel",
   "bin": {
     "remotego": "bin/remotego.js"

package/scripts/remoting.sh

@@ -1,11 +1,21 @@
 #!/bin/bash
 
 # remoting.sh - Mirror a CLI tool in a browser (Claude plugin default: claude)
-# Usage: remoting.sh [port]
+# Usage: remoting.sh [port] [--domain <domain>]
 
 set -euo pipefail
 
-PORT="${1:-7681}"
+PORT="7681"
+DOMAIN=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --domain)
+      DOMAIN="$2"; shift 2 ;;
+    *)
+      PORT="$1"; shift ;;
+  esac
+done
 
 # Check Node.js
 if ! command -v node &>/dev/null; then
@@ -27,4 +37,11 @@ fi
 # Save caller's cwd so the command starts in the right directory
 REMOTE_CWD="$(pwd)"
 cd "$SERVER_DIR"
-exec env PORT="$PORT" REMOTE_CMD="claude" REMOTE_ARGS="[]" REMOTE_CWD="$REMOTE_CWD" node server.js
+
+# Build tunnel domain env var if specified
+TUNNEL_ENV=""
+if [ -n "$DOMAIN" ]; then
+  TUNNEL_ENV="TUNNEL_DOMAIN=$DOMAIN"
+fi
+
+exec env PORT="$PORT" REMOTE_CMD="claude" REMOTE_ARGS="[]" REMOTE_CWD="$REMOTE_CWD" $TUNNEL_ENV node server.js

package/server/server.js

@@ -12,6 +12,7 @@ const __dirname = dirname(__filename);
 
 const PORT = process.env.PORT || 7681;
 const SESSION_ID = randomUUID();
+const TUNNEL_DOMAIN = process.env.TUNNEL_DOMAIN || '';
 const clients = new Set();
 
 // Command to run in PTY — configurable via env vars
@@ -204,9 +205,14 @@ server.listen(PORT, () => {
 });
 
 function startTunnel(localUrl) {
+  // Build SSH -R argument: custom domain or random subdomain
+  const remoteArg = TUNNEL_DOMAIN
+    ? `${TUNNEL_DOMAIN}:80:localhost:${PORT}`
+    : `80:localhost:${PORT}`;
+
   const tunnel = spawn('ssh', [
     '-o', 'StrictHostKeyChecking=no',
-    '-R', `80:localhost:${PORT}`,
+    '-R', remoteArg,
     'nokey@localhost.run',
   ], {
     name: 'xterm-256color',