@seflless/ghosttown 1.2.4 → 1.3.0

package/bin/ghosttown.js

@@ -3,22 +3,24 @@
 /**
  * ghosttown CLI - Web-based terminal emulator
  *
- * Starts a local HTTP server with WebSocket PTY support.
+ * Starts a local HTTP server with WebSocket PTY support,
+ * or runs a command in a new tmux session.
  *
  * Usage:
- *   ghosttown [options]
+ *   ghosttown [options] [command]
  *
  * Options:
  *   -p, --port <port>  Port to listen on (default: 8080, or PORT env var)
  *   -h, --help         Show this help message
  *
  * Examples:
- *   ghosttown
- *   ghosttown -p 3000
- *   ghosttown --port 3000
- *   PORT=3000 ghosttown
+ *   ghosttown                    Start the web terminal server
+ *   ghosttown -p 3000            Start the server on port 3000
+ *   ghosttown vim                Run vim in a new tmux session
+ *   ghosttown "npm run dev"      Run npm in a new tmux session
  */
 
+import { execSync, spawn } from 'child_process';
 import fs from 'fs';
 import http from 'http';
 import { homedir, networkInterfaces } from 'os';
@@ -35,6 +37,118 @@ import { asciiArt } from './ascii.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+// ============================================================================
+// Tmux Session Management
+// ============================================================================
+
+/**
+ * Check if tmux is installed
+ */
+function checkTmuxInstalled() {
+  try {
+    execSync('which tmux', { stdio: 'pipe' });
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+
+/**
+ * Print tmux installation instructions and exit
+ */
+function printTmuxInstallHelp() {
+  console.error('\x1b[31mError: tmux is not installed.\x1b[0m\n');
+  console.error('tmux is required to run commands in ghosttown sessions.\n');
+  console.error('To install tmux:\n');
+
+  if (process.platform === 'darwin') {
+    console.error('  \x1b[36mmacOS (Homebrew):\x1b[0m  brew install tmux');
+    console.error('  \x1b[36mmacOS (MacPorts):\x1b[0m  sudo port install tmux');
+  } else if (process.platform === 'linux') {
+    console.error('  \x1b[36mDebian/Ubuntu:\x1b[0m  sudo apt install tmux');
+    console.error('  \x1b[36mFedora:\x1b[0m         sudo dnf install tmux');
+    console.error('  \x1b[36mArch:\x1b[0m           sudo pacman -S tmux');
+  } else {
+    console.error('  Please install tmux using your system package manager.');
+  }
+
+  console.error('');
+  process.exit(1);
+}
+
+/**
+ * Get the next available ghosttown session ID
+ * Scans existing tmux sessions named ghosttown-<N> and returns max(N) + 1
+ */
+function getNextSessionId() {
+  try {
+    // List all tmux sessions
+    const output = execSync('tmux list-sessions -F "#{session_name}"', {
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+
+    // Find all ghosttown-<N> sessions and extract IDs
+    const sessionIds = output
+      .split('\n')
+      .filter((name) => name.startsWith('ghosttown-'))
+      .map((name) => {
+        const id = parseInt(name.replace('ghosttown-', ''), 10);
+        return isNaN(id) ? 0 : id;
+      });
+
+    // Return max + 1, or 1 if no sessions exist
+    return sessionIds.length > 0 ? Math.max(...sessionIds) + 1 : 1;
+  } catch (err) {
+    // tmux not running or no sessions - start with 1
+    return 1;
+  }
+}
+
+/**
+ * Create a new tmux session and run the command
+ */
+function createTmuxSession(command) {
+  // Check if tmux is installed
+  if (!checkTmuxInstalled()) {
+    printTmuxInstallHelp();
+  }
+
+  const sessionId = getNextSessionId();
+  const sessionName = `ghosttown-${sessionId}`;
+
+  try {
+    // Create tmux session and attach directly (not detached)
+    // Use -x and -y to set initial size, avoiding "terminal too small" issues
+    // The command runs in the session, and we attach immediately
+    const attach = spawn(
+      'tmux',
+      [
+        'new-session',
+        '-s',
+        sessionName,
+        '-x',
+        '200',
+        '-y',
+        '50',
+        // Set status off (no HUD), run the command, then start a shell
+        // so the session stays open and interactive after command completes
+        'tmux set-option status off; ' + command + '; exec $SHELL',
+      ],
+      {
+        stdio: 'inherit',
+      }
+    );
+
+    attach.on('exit', (code) => {
+      process.exit(code || 0);
+    });
+  } catch (err) {
+    console.error(`Error creating tmux session: ${err.message}`);
+    process.exit(1);
+  }
+}
+
 // ============================================================================
 // Parse CLI arguments
 // ============================================================================
@@ -42,23 +156,28 @@ const __dirname = path.dirname(__filename);
 function parseArgs() {
   const args = process.argv.slice(2);
   let port = null;
+  let command = null;
 
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
 
     if (arg === '-h' || arg === '--help') {
       console.log(`
-Usage: ghosttown [options]
+Usage: ghosttown [options] [command]
 
 Options:
   -p, --port <port>  Port to listen on (default: 8080, or PORT env var)
   -h, --help         Show this help message
 
+Commands:
+  If a command is provided, ghosttown creates a new tmux session
+  named ghosttown-<id> (with status bar disabled) and runs the command.
+
 Examples:
-  ghosttown
-  ghosttown -p 3000
-  ghosttown --port 3000
-  PORT=3000 ghosttown
+  ghosttown                    Start the web terminal server
+  ghosttown -p 3000            Start the server on port 3000
+  ghosttown vim                Run vim in a new tmux session
+  ghosttown "npm run dev"      Run npm in a new tmux session
 `);
       process.exit(0);
     }
@@ -75,14 +194,33 @@ Examples:
         process.exit(1);
       }
       i++; // Skip the next argument since we consumed it
+      continue;
+    }
+
+    // Any non-flag argument is treated as the command
+    if (!arg.startsWith('-')) {
+      command = arg;
     }
   }
 
-  return { port };
+  return { port, command };
 }
 
 const cliArgs = parseArgs();
-const HTTP_PORT = cliArgs.port || process.env.PORT || 8080;
+
+// If a command is provided, create a tmux session instead of starting server
+if (cliArgs.command) {
+  createTmuxSession(cliArgs.command);
+  // createTmuxSession spawns tmux attach and waits for it to exit
+  // The script will exit when tmux attach exits (via the exit handler)
+  // We must not continue to server code, so we stop here
+} else {
+  // Server mode (no command provided)
+  startWebServer();
+}
+
+function startWebServer() {
+  const HTTP_PORT = cliArgs.port || process.env.PORT || 8080;
 
 // ============================================================================
 // Locate ghosttown assets
@@ -708,3 +846,4 @@ httpServer.listen(HTTP_PORT, '0.0.0.0', async () => {
 
   printBanner(`http://localhost:${HTTP_PORT}`);
 });
+} // end startWebServer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seflless/ghosttown",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "description": "Web-based terminal emulator using Ghostty's VT100 parser via WebAssembly",
   "type": "module",
   "main": "./dist/ghostty-web.umd.cjs",
@@ -64,7 +64,8 @@
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "prepublishOnly": "bun run build",
-    "cli:publish": "node scripts/cli-publish.js"
+    "cli:publish": "node scripts/cli-publish.js",
+    "kill:8080": "kill -9 $(lsof -ti :8080)"
   },
   "dependencies": {
     "@lydell/node-pty": "^1.0.1",