remotosh 1.0.0

package/.env.example

@@ -0,0 +1,10 @@
+# Remoto CLI Configuration
+
+# Your API key (get from https://remoto.sh/dashboard/api-keys)
+REMOTO_API_KEY=rmt_your-api-key-here
+
+# WebSocket server URL
+REMOTO_WS_URL=wss://remoto-ws.fly.dev
+
+# Web app URL (for QR code)
+REMOTO_WEB_URL=https://remoto.sh

package/bin/remoto.js

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+
+import os from 'os';
+import pty from 'node-pty';
+import qrcode from 'qrcode-terminal';
+import WebSocket from 'ws';
+import chalk from 'chalk';
+
+// Configuration
+const WS_SERVER_URL = process.env.REMOTO_WS_URL || 'wss://remoto-ws.fly.dev';
+const WEB_APP_URL = process.env.REMOTO_WEB_URL || 'https://remoto.sh';
+const API_KEY = process.env.REMOTO_API_KEY;
+
+// Detect shell
+const shell = process.env.SHELL || (os.platform() === 'win32' ? 'powershell.exe' : 'zsh');
+
+// Terminal dimensions
+let cols = process.stdout.columns || 80;
+let rows = process.stdout.rows || 24;
+
+console.clear();
+console.log(chalk.bold.white('\n  remoto'));
+console.log(chalk.dim('  control your terminal from your phone\n'));
+console.log(chalk.dim('  connecting...'));
+
+// Connect to WebSocket server (API key is optional)
+const wsUrl = API_KEY
+  ? `${WS_SERVER_URL}/cli/?apiKey=${encodeURIComponent(API_KEY)}`
+  : `${WS_SERVER_URL}/cli/`;
+const ws = new WebSocket(wsUrl);
+
+let ptyProcess = null;
+let sessionId = null;
+let sessionToken = null;
+let isAnonymous = true;
+let outputBuffer = '';
+let flushTimeout = null;
+
+ws.on('open', () => {
+  // Connection established, wait for session_created message
+});
+
+ws.on('message', (data) => {
+  try {
+    const message = JSON.parse(data.toString());
+    handleServerMessage(message);
+  } catch (err) {
+    console.error(chalk.red('  invalid message from server'));
+  }
+});
+
+ws.on('close', (code, reason) => {
+  console.log(chalk.dim(`\n  disconnected (${code})`));
+  cleanup();
+});
+
+ws.on('error', (err) => {
+  console.error(chalk.red(`\n  connection error: ${err.message}`));
+  if (err.message.includes('ECONNREFUSED')) {
+    console.log(chalk.dim('\n  make sure you have internet access'));
+  }
+  process.exit(1);
+});
+
+function handleServerMessage(message) {
+  switch (message.type) {
+    case 'session_created':
+      sessionId = message.sessionId;
+      sessionToken = message.sessionToken;
+      isAnonymous = message.isAnonymous;
+      showQRCode();
+      startPTY();
+      break;
+
+    case 'phone_connected':
+      console.log(chalk.green(`\n  phone connected`));
+      if (message.phoneCount > 1) {
+        console.log(chalk.dim(`  ${message.phoneCount} devices connected`));
+      }
+      console.log('');
+      break;
+
+    case 'phone_disconnected':
+      if (message.phoneCount > 0) {
+        console.log(chalk.yellow(`\n  phone disconnected (${message.phoneCount} remaining)\n`));
+      } else {
+        console.log(chalk.yellow(`\n  phone disconnected\n`));
+      }
+      break;
+
+    case 'input':
+      // Input from phone
+      if (ptyProcess) {
+        ptyProcess.write(message.data);
+      }
+      break;
+
+    case 'resize':
+      // Resize from phone
+      if (ptyProcess && message.cols && message.rows) {
+        ptyProcess.resize(message.cols, message.rows);
+      }
+      break;
+
+    default:
+      // Ignore unknown messages
+  }
+}
+
+function showQRCode() {
+  const connectionUrl = `${WEB_APP_URL}/session/${sessionId}?token=${sessionToken}`;
+
+  console.clear();
+  console.log(chalk.bold.white('\n  remoto'));
+  console.log(chalk.dim('  control your terminal from your phone\n'));
+
+  qrcode.generate(connectionUrl, { small: true }, (qr) => {
+    // Indent the QR code
+    const indentedQr = qr.split('\n').map(line => '  ' + line).join('\n');
+    console.log(indentedQr);
+    console.log(chalk.dim(`\n  ${connectionUrl}\n`));
+    console.log(chalk.dim('  scan the qr code or open the link on your phone'));
+    console.log(chalk.dim('  waiting for connection...\n'));
+    console.log(chalk.dim('─'.repeat(Math.min(cols, 60))));
+  });
+}
+
+function startPTY() {
+  // Initialize PTY
+  ptyProcess = pty.spawn(shell, [], {
+    name: 'xterm-256color',
+    cols,
+    rows,
+    cwd: process.cwd(),
+    env: process.env,
+  });
+
+  // Handle PTY output
+  ptyProcess.onData((data) => {
+    // Write to local terminal
+    process.stdout.write(data);
+
+    // Buffer and send to server
+    outputBuffer += data;
+
+    if (flushTimeout) clearTimeout(flushTimeout);
+    flushTimeout = setTimeout(() => {
+      if (outputBuffer && ws.readyState === WebSocket.OPEN) {
+        // Chunk large outputs
+        const chunks = chunkString(outputBuffer, 16000);
+        for (const chunk of chunks) {
+          ws.send(JSON.stringify({ type: 'output', data: chunk }));
+        }
+        outputBuffer = '';
+      }
+    }, 30);
+  });
+
+  // Handle PTY exit
+  ptyProcess.onExit(({ exitCode }) => {
+    console.log(chalk.dim(`\n  session ended`));
+
+    // Show account nudge for anonymous users
+    if (isAnonymous) {
+      console.log(chalk.dim('\n  ─────────────────────────────────────────'));
+      console.log(chalk.white('\n  create an account to save session history'));
+      console.log(chalk.dim(`  ${WEB_APP_URL}/signup\n`));
+    }
+
+    if (ws.readyState === WebSocket.OPEN) {
+      ws.send(JSON.stringify({ type: 'exit', code: exitCode }));
+      ws.close();
+    }
+    process.exit(exitCode);
+  });
+
+  // Handle local terminal resize
+  process.stdout.on('resize', () => {
+    cols = process.stdout.columns;
+    rows = process.stdout.rows;
+    if (ptyProcess) {
+      ptyProcess.resize(cols, rows);
+    }
+  });
+
+  // Handle local input
+  process.stdin.setRawMode(true);
+  process.stdin.resume();
+  process.stdin.on('data', (data) => {
+    if (ptyProcess) {
+      ptyProcess.write(data.toString());
+    }
+  });
+}
+
+function cleanup() {
+  if (ptyProcess) {
+    ptyProcess.kill();
+  }
+  if (ws.readyState === WebSocket.OPEN) {
+    ws.close();
+  }
+  process.exit();
+}
+
+// Cleanup on exit
+process.on('SIGINT', cleanup);
+process.on('SIGTERM', cleanup);
+
+// Helper to chunk strings
+function chunkString(str, size) {
+  const chunks = [];
+  for (let i = 0; i < str.length; i += size) {
+    chunks.push(str.slice(i, i + size));
+  }
+  return chunks.length ? chunks : [''];
+}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "remotosh",
+  "version": "1.0.0",
+  "description": "Control your terminal from your phone",
+  "type": "module",
+  "bin": {
+    "remoto": "./bin/remoto.js"
+  },
+  "scripts": {
+    "dev": "node bin/remoto.js",
+    "build": "echo 'No build step needed'"
+  },
+  "dependencies": {
+    "node-pty": "^1.0.0",
+    "qrcode-terminal": "^0.12.0",
+    "ws": "^8.18.0",
+    "chalk": "^5.3.0"
+  }
+}