@mjasano/devtunnel 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,18 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(cat:*)",
+      "Bash(brew install:*)",
+      "Bash(npm start)",
+      "Bash(curl:*)",
+      "Bash(cloudflared tunnel:*)",
+      "Bash(pkill:*)",
+      "Bash(chmod:*)",
+      "Bash(node bin/cli.js:*)",
+      "Bash(npm whoami:*)",
+      "Bash(npm config set:*)",
+      "Bash(npm view:*)",
+      "Bash(npm publish:*)"
+    ]
+  }
+}

package/Dockerfile

@@ -0,0 +1,41 @@
+FROM node:20-slim
+
+# Install dependencies
+RUN apt-get update && apt-get install -y \
+    curl \
+    git \
+    build-essential \
+    python3 \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install cloudflared
+RUN curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o /usr/local/bin/cloudflared \
+    && chmod +x /usr/local/bin/cloudflared
+
+# Install Claude CLI
+RUN npm install -g @anthropic-ai/claude-code
+
+# Create app directory
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install app dependencies
+RUN npm install
+
+# Copy app source
+COPY . .
+
+# Create workspace directory
+RUN mkdir -p /workspace
+
+# Environment variables
+ENV PORT=3000
+ENV WORKSPACE=/workspace
+
+# Expose port
+EXPOSE 3000
+
+# Start the server
+CMD ["node", "server.js"]

package/bin/cli.js

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+
+const { spawn, execSync } = require('child_process');
+const path = require('path');
+const http = require('http');
+
+const VERSION = '1.0.0';
+
+// Colors
+const c = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  magenta: '\x1b[35m',
+};
+
+function log(msg) {
+  console.log(msg);
+}
+
+function banner() {
+  log('');
+  log(`${c.cyan}${c.bold}  ____           _____                       _  ${c.reset}`);
+  log(`${c.cyan}${c.bold} |  _ \\  _____  _|_   _|   _ _ __  _ __   ___| | ${c.reset}`);
+  log(`${c.cyan}${c.bold} | | | |/ _ \\ \\/ / | || | | | '_ \\| '_ \\ / _ \\ | ${c.reset}`);
+  log(`${c.cyan}${c.bold} | |_| |  __/>  <  | || |_| | | | | | | |  __/ | ${c.reset}`);
+  log(`${c.cyan}${c.bold} |____/ \\___/_/\\_\\ |_| \\__,_|_| |_|_| |_|\\___|_| ${c.reset}`);
+  log('');
+  log(`${c.dim}  Web Terminal + Tunnel Manager v${VERSION}${c.reset}`);
+  log('');
+}
+
+function checkCloudflared() {
+  try {
+    execSync('which cloudflared', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function installCloudflared() {
+  log(`${c.yellow}cloudflared not found. Installing...${c.reset}`);
+
+  const platform = process.platform;
+
+  try {
+    if (platform === 'darwin') {
+      log(`${c.dim}Running: brew install cloudflared${c.reset}`);
+      execSync('brew install cloudflared', { stdio: 'inherit' });
+    } else if (platform === 'linux') {
+      log(`${c.dim}Downloading cloudflared...${c.reset}`);
+      execSync('curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o /usr/local/bin/cloudflared && chmod +x /usr/local/bin/cloudflared', { stdio: 'inherit' });
+    } else {
+      log(`${c.red}Please install cloudflared manually: https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation/${c.reset}`);
+      process.exit(1);
+    }
+    log(`${c.green}cloudflared installed successfully!${c.reset}`);
+  } catch (err) {
+    log(`${c.red}Failed to install cloudflared: ${err.message}${c.reset}`);
+    log(`${c.yellow}Please install manually: https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation/${c.reset}`);
+    process.exit(1);
+  }
+}
+
+function waitForServer(port, timeout = 10000) {
+  return new Promise((resolve, reject) => {
+    const start = Date.now();
+
+    const check = () => {
+      const req = http.get(`http://localhost:${port}/health`, (res) => {
+        if (res.statusCode === 200) {
+          resolve();
+        } else {
+          retry();
+        }
+      });
+
+      req.on('error', retry);
+      req.setTimeout(1000);
+    };
+
+    const retry = () => {
+      if (Date.now() - start > timeout) {
+        reject(new Error('Server startup timeout'));
+      } else {
+        setTimeout(check, 500);
+      }
+    };
+
+    check();
+  });
+}
+
+function startServer(port) {
+  const serverPath = path.join(__dirname, '..', 'server.js');
+
+  const server = spawn('node', [serverPath], {
+    env: { ...process.env, PORT: port },
+    stdio: ['ignore', 'pipe', 'pipe'],
+    detached: false
+  });
+
+  server.stdout.on('data', (data) => {
+    const msg = data.toString().trim();
+    if (msg) log(`${c.dim}[server] ${msg}${c.reset}`);
+  });
+
+  server.stderr.on('data', (data) => {
+    const msg = data.toString().trim();
+    if (msg) log(`${c.red}[server] ${msg}${c.reset}`);
+  });
+
+  return server;
+}
+
+function startTunnel(port) {
+  return new Promise((resolve, reject) => {
+    const tunnel = spawn('cloudflared', ['tunnel', '--url', `http://localhost:${port}`], {
+      stdio: ['ignore', 'pipe', 'pipe']
+    });
+
+    let resolved = false;
+
+    const handleOutput = (data) => {
+      const output = data.toString();
+      const match = output.match(/https:\/\/[a-zA-Z0-9-]+\.trycloudflare\.com/);
+      if (match && !resolved) {
+        resolved = true;
+        resolve({ tunnel, url: match[0] });
+      }
+    };
+
+    tunnel.stdout.on('data', handleOutput);
+    tunnel.stderr.on('data', handleOutput);
+
+    tunnel.on('error', (err) => {
+      if (!resolved) reject(err);
+    });
+
+    setTimeout(() => {
+      if (!resolved) {
+        reject(new Error('Tunnel creation timeout'));
+      }
+    }, 30000);
+  });
+}
+
+function showSuccess(url) {
+  log('');
+  log(`${c.green}${c.bold}  Ready!${c.reset}`);
+  log('');
+  log(`${c.bold}  Access from anywhere:${c.reset}`);
+  log(`  ${c.cyan}${c.bold}${url}${c.reset}`);
+  log('');
+  log(`${c.dim}  Features:${c.reset}`);
+  log(`${c.dim}  - Web terminal with session persistence${c.reset}`);
+  log(`${c.dim}  - Expose local ports to the internet${c.reset}`);
+  log(`${c.dim}  - Run Claude CLI and develop anywhere${c.reset}`);
+  log('');
+  log(`${c.yellow}  Press Ctrl+C to stop${c.reset}`);
+  log('');
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0] || 'start';
+
+  if (command === '--help' || command === '-h') {
+    banner();
+    log(`${c.bold}Usage:${c.reset}`);
+    log(`  devtunnel              Start DevTunnel`);
+    log(`  devtunnel start        Start DevTunnel`);
+    log(`  devtunnel --port 8080  Use custom port`);
+    log(`  devtunnel --help       Show this help`);
+    log(`  devtunnel --version    Show version`);
+    log('');
+    return;
+  }
+
+  if (command === '--version' || command === '-v') {
+    log(`devtunnel v${VERSION}`);
+    return;
+  }
+
+  // Parse port
+  let port = 3000;
+  const portIndex = args.indexOf('--port');
+  if (portIndex !== -1 && args[portIndex + 1]) {
+    port = parseInt(args[portIndex + 1]);
+  }
+
+  banner();
+
+  // Check cloudflared
+  log(`${c.dim}Checking dependencies...${c.reset}`);
+  if (!checkCloudflared()) {
+    installCloudflared();
+  }
+  log(`${c.green}✓${c.reset} cloudflared`);
+
+  // Start server
+  log(`${c.dim}Starting server on port ${port}...${c.reset}`);
+  const server = startServer(port);
+
+  try {
+    await waitForServer(port);
+    log(`${c.green}✓${c.reset} Server running`);
+  } catch (err) {
+    log(`${c.red}✗ Failed to start server: ${err.message}${c.reset}`);
+    server.kill();
+    process.exit(1);
+  }
+
+  // Start tunnel
+  log(`${c.dim}Creating tunnel...${c.reset}`);
+  try {
+    const { tunnel, url } = await startTunnel(port);
+    log(`${c.green}✓${c.reset} Tunnel created`);
+
+    showSuccess(url);
+
+    // Handle shutdown
+    const cleanup = () => {
+      log('');
+      log(`${c.dim}Shutting down...${c.reset}`);
+      tunnel.kill();
+      server.kill();
+      process.exit(0);
+    };
+
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+
+  } catch (err) {
+    log(`${c.red}✗ Failed to create tunnel: ${err.message}${c.reset}`);
+    server.kill();
+    process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  log(`${c.red}Error: ${err.message}${c.reset}`);
+  process.exit(1);
+});

package/docker-compose.yml

@@ -0,0 +1,14 @@
+services:
+  devtunnel:
+    build: .
+    ports:
+      - "3000:3000"
+    volumes:
+      - ./workspace:/workspace
+      - claude-config:/root/.claude
+    environment:
+      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
+    restart: unless-stopped
+
+volumes:
+  claude-config:

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@mjasano/devtunnel",
+  "version": "1.0.0",
+  "description": "Web terminal with tunnel manager - access your dev environment from anywhere",
+  "main": "server.js",
+  "bin": {
+    "devtunnel": "./bin/cli.js"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "dev": "node server.js"
+  },
+  "keywords": [
+    "terminal",
+    "web-terminal",
+    "tunnel",
+    "cloudflare",
+    "remote-development"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@homebridge/node-pty-prebuilt-multiarch": "^0.13.1",
+    "express": "^4.18.2",
+    "ws": "^8.14.2"
+  }
+}