@seflless/ghosttown 1.3.1 → 1.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seflless/ghosttown",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "Web-based terminal emulator using Ghostty's VT100 parser via WebAssembly",
   "type": "module",
   "main": "./dist/ghostty-web.umd.cjs",

package/scripts/postinstall.js

@@ -11,6 +11,7 @@
  */
 
 import { execSync } from 'child_process';
+import { readlinkSync } from 'fs';
 
 /**
  * Check if we're on a supported platform (macOS or Linux)
@@ -44,13 +45,37 @@ function isOurCommand(resolvedPath) {
 
   // Check if the path contains indicators that it's from our package
   const indicators = [
+    // Direct package installs
     'node_modules/ghosttown',
     'node_modules/@seflless/ghosttown',
+    // Local development (running from repo root)
     '/ghosttown/bin/gt',
+    // Scoped package reference
+    '@seflless/ghosttown',
   ];
 
   const normalizedPath = resolvedPath.toLowerCase();
-  return indicators.some((indicator) => normalizedPath.includes(indicator.toLowerCase()));
+
+  // Direct indicator match
+  if (indicators.some((indicator) => normalizedPath.includes(indicator.toLowerCase()))) {
+    return true;
+  }
+
+  // If the path is in node_modules/.bin, it's likely a symlink created by npm/bun
+  // for this package. Check if it's a symlink and read its target.
+  if (normalizedPath.includes('node_modules/.bin/gt')) {
+    try {
+      const target = readlinkSync(resolvedPath);
+      // The symlink target will be something like ../@seflless/ghosttown/bin/gt.js
+      if (target.includes('@seflless/ghosttown') || target.includes('ghosttown/bin/gt')) {
+        return true;
+      }
+    } catch (err) {
+      // Not a symlink or can't read - continue with other checks
+    }
+  }
+
+  return false;
 }
 
 /**

package/src/cli.js

@@ -18,7 +18,7 @@
  *   ghosttown "npm run dev"      Run npm in a new tmux session
  */
 
-import { execSync, spawn } from 'child_process';
+import { execSync, spawn, spawnSync } from 'child_process';
 import fs from 'fs';
 import http from 'http';
 import { homedir, networkInterfaces } from 'os';
@@ -55,23 +55,50 @@ function checkTmuxInstalled() {
  * 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.');
+  const RESET = '\x1b[0m';
+  const RED = '\x1b[31m';
+  const CYAN = '\x1b[36m';
+  const BEIGE = '\x1b[38;2;255;220;150m';
+  const DIM = '\x1b[2m';
+
+  console.log('');
+  console.log(`   ${RED}ghosttown needs tmux to be installed.${RESET}`);
+  console.log(`   ${DIM}tmux is used to manage terminal sessions.${RESET}`);
+  console.log('');
+  console.log(`   ${CYAN}To install:${RESET}  ${BEIGE}brew install tmux${RESET}`);
+  console.log('');
+  process.exit(1);
+}
+
+/**
+ * Check if currently inside a tmux session
+ */
+function isInsideTmux() {
+  return !!process.env.TMUX;
+}
+
+/**
+ * Get the name of the current tmux session
+ * Returns null if not inside tmux
+ */
+function getCurrentTmuxSessionName() {
+  if (!isInsideTmux()) return null;
+  try {
+    return execSync('tmux display-message -p "#{session_name}"', {
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+  } catch (err) {
+    return null;
   }
+}
 
-  console.error('');
-  process.exit(1);
+/**
+ * Check if currently inside a ghosttown session (named ghosttown-<N>)
+ */
+function isInsideGhosttownSession() {
+  const sessionName = getCurrentTmuxSessionName();
+  return sessionName && sessionName.startsWith('ghosttown-');
 }
 
 /**
@@ -112,6 +139,10 @@ function listSessions() {
     printTmuxInstallHelp();
   }
 
+  const RESET = '\x1b[0m';
+  const CYAN = '\x1b[36m';
+  const BEIGE = '\x1b[38;2;255;220;150m';
+
   try {
     // Get detailed session information
     const output = execSync(
@@ -136,43 +167,39 @@ function listSessions() {
       });
 
     if (sessions.length === 0) {
-      console.log('No ghosttown sessions running.');
-      console.log('\nTo create a session, run:');
-      console.log('  ghosttown <command>');
-      console.log('\nExample:');
-      console.log('  ghosttown vim');
+      console.log('');
+      console.log(`   ${BEIGE}No ghosttown sessions are currently running.${RESET}`);
+      console.log('');
       process.exit(0);
     }
 
     // Print header
     console.log('\n\x1b[1mGhosttown Sessions\x1b[0m\n');
     console.log(
-      `\x1b[36m${'Name'.padEnd(15)}  ${'Created'.padEnd(22)}  ${'Status'.padEnd(10)}  Windows\x1b[0m`
+      `${CYAN}${'Name'.padEnd(15)}  ${'Created'.padEnd(22)}  ${'Status'.padEnd(10)}  Windows${RESET}`
     );
-    console.log('-'.repeat(65));
 
     // Print sessions
     for (const session of sessions) {
       const createdStr = session.created.toLocaleString();
       // Status has ANSI codes so we need to pad the visible text differently
       const statusPadded = session.attached
-        ? `\x1b[32m${'attached'.padEnd(10)}\x1b[0m`
-        : `\x1b[33m${'detached'.padEnd(10)}\x1b[0m`;
+        ? `\x1b[32m${'attached'.padEnd(10)}${RESET}`
+        : `\x1b[33m${'detached'.padEnd(10)}${RESET}`;
       console.log(
         `${session.name.padEnd(15)}  ${createdStr.padEnd(22)}  ${statusPadded}  ${session.windows}`
       );
     }
 
     console.log('');
-    console.log(`Total: ${sessions.length} session(s)`);
+    const sessionWord = sessions.length === 1 ? 'session' : 'sessions';
+    console.log(`Total: ${sessions.length} ${sessionWord}`);
     console.log('');
   } catch (err) {
     // tmux not running or no sessions
-    console.log('No ghosttown sessions running.');
-    console.log('\nTo create a session, run:');
-    console.log('  ghosttown <command>');
-    console.log('\nExample:');
-    console.log('  ghosttown vim');
+    console.log('');
+    console.log(`   ${BEIGE}No ghosttown sessions are currently running.${RESET}`);
+    console.log('');
   }
 
   process.exit(0);
@@ -222,6 +249,258 @@ function createTmuxSession(command) {
   }
 }
 
+/**
+ * Print styled detach success message
+ */
+function printDetachMessage(sessionName) {
+  const RESET = '\x1b[0m';
+  const CYAN = '\x1b[36m';
+  const BEIGE = '\x1b[38;2;255;220;150m';
+  const DIM = '\x1b[2m';
+  const BOLD_YELLOW = '\x1b[1;93m';
+  const labelWidth = Math.max('To reattach:'.length, 'To list all sessions:'.length);
+  const formatHint = (label, command) =>
+    `   ${CYAN}${label.padStart(labelWidth)}${RESET} ${BEIGE}${command}${RESET}`;
+
+  return [
+    '',
+    `   ${BOLD_YELLOW}You've detached from your ghosttown session.${RESET}`,
+    `   ${DIM}It's now running in the background.${RESET}`,
+    '',
+    formatHint('To reattach:', `ghosttown attach ${sessionName}`),
+    '',
+    formatHint('To list all sessions:', 'ghosttown list'),
+    '',
+    '',
+  ].join('\n');
+}
+
+/**
+ * Detach from the current ghosttown tmux session
+ */
+function detachFromTmux() {
+  const RESET = '\x1b[0m';
+  const RED = '\x1b[31m';
+  const DIM = '\x1b[2m';
+  const BEIGE = '\x1b[38;2;255;220;150m';
+
+  // Check if we're inside tmux at all
+  if (!isInsideTmux()) {
+    console.log('');
+    console.log(`   ${RED}Error:${RESET} Not inside a tmux session.`);
+    console.log('');
+    console.log(`   ${BEIGE}No ghosttown sessions are currently running.${RESET}`);
+    console.log('');
+    process.exit(1);
+  }
+
+  // Check if we're inside a ghosttown session specifically
+  if (!isInsideGhosttownSession()) {
+    console.log('');
+    console.log(`   ${RED}Error:${RESET} Not inside a ghosttown session.`);
+    console.log('');
+    console.log(`   ${DIM}You're in a tmux session, but not one created by ghosttown.${RESET}`);
+    console.log(
+      `   ${DIM}To detach from this tmux session, use: tmux detach (or ctrl+b d)${RESET}`
+    );
+    console.log('');
+    process.exit(1);
+  }
+
+  // Get the session name for the message
+  const sessionName = getCurrentTmuxSessionName();
+  const message = printDetachMessage(sessionName);
+  const messageForShell = message.replace(/'/g, "'\\''");
+
+  // Detach only the current client (not all attached clients).
+  // Use client_tty so multiple attached windows aren't all detached.
+  let result = null;
+  let clientTty = null;
+  try {
+    clientTty = execSync('tmux display-message -p "#{client_tty}"', {
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+
+    if (clientTty) {
+      result = spawnSync(
+        'tmux',
+        ['detach-client', '-t', clientTty, '-E', `printf %s '${messageForShell}'`],
+        {
+          stdio: 'inherit',
+        }
+      );
+    }
+  } catch (err) {
+    // Fall back to generic detach below.
+  }
+
+  if (!result) {
+    // Detach using shell execution to avoid nesting warnings
+    result = spawnSync(process.env.SHELL || '/bin/sh', ['-c', 'exec tmux detach'], {
+      stdio: 'inherit',
+    });
+  }
+
+  // If we couldn't target a client tty, fall back to stdout.
+  if (!clientTty) {
+    process.stdout.write(message);
+  }
+
+  process.exit(result.status || 0);
+}
+
+/**
+ * Attach to a ghosttown session
+ */
+function attachToSession(sessionName) {
+  // Check if tmux is installed
+  if (!checkTmuxInstalled()) {
+    printTmuxInstallHelp();
+  }
+
+  const RESET = '\x1b[0m';
+  const RED = '\x1b[31m';
+  const BEIGE = '\x1b[38;2;255;220;150m';
+
+  // Add ghosttown- prefix if not present
+  if (!sessionName.startsWith('ghosttown-')) {
+    sessionName = `ghosttown-${sessionName}`;
+  }
+
+  // Check if session exists
+  try {
+    const output = execSync('tmux list-sessions -F "#{session_name}"', {
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+
+    const sessions = output.split('\n').filter((s) => s.trim());
+    if (!sessions.includes(sessionName)) {
+      console.log('');
+      console.log(`   ${RED}Error:${RESET} Session '${sessionName}' not found.`);
+      console.log('');
+      console.log(`   ${BEIGE}No ghosttown sessions are currently running.${RESET}`);
+      console.log('');
+      process.exit(1);
+    }
+  } catch (err) {
+    console.log('');
+    console.log(`   ${RED}Error:${RESET} No tmux sessions found.`);
+    console.log('');
+    console.log(`   ${BEIGE}No ghosttown sessions are currently running.${RESET}`);
+    console.log('');
+    process.exit(1);
+  }
+
+  // Attach to the session using spawn with shell
+  // Use the same pattern as detachFromTmux which works
+  const result = spawnSync(
+    process.env.SHELL || '/bin/sh',
+    ['-c', `tmux attach-session -t ${sessionName}`],
+    {
+      stdio: 'inherit',
+    }
+  );
+
+  process.exit(result.status || 0);
+}
+
+/**
+ * Kill a ghosttown session
+ * If sessionName is null, kills the current session (if inside one)
+ */
+function killSession(sessionName) {
+  // Check if tmux is installed
+  if (!checkTmuxInstalled()) {
+    printTmuxInstallHelp();
+  }
+
+  const RESET = '\x1b[0m';
+  const RED = '\x1b[31m';
+  const CYAN = '\x1b[36m';
+  const BEIGE = '\x1b[38;2;255;220;150m';
+  const DIM = '\x1b[2m';
+  const BOLD_YELLOW = '\x1b[1;93m';
+
+  // If no session specified, try to kill current session
+  if (!sessionName) {
+    if (!isInsideTmux()) {
+      console.log('');
+      console.log(`   ${RED}Error:${RESET} No session specified and not inside a tmux session.`);
+      console.log('');
+      console.log(`   ${DIM}Usage:${RESET}`);
+      console.log(`   ${DIM}  ghosttown -k <session>  Kill a specific session${RESET}`);
+      console.log(
+        `   ${DIM}  ghosttown -k            Kill current session (when inside one)${RESET}`
+      );
+      console.log('');
+      process.exit(1);
+    }
+
+    if (!isInsideGhosttownSession()) {
+      console.log('');
+      console.log(`   ${RED}Error:${RESET} Not inside a ghosttown session.`);
+      console.log('');
+      console.log(`   ${DIM}You're in a tmux session, but not one created by ghosttown.${RESET}`);
+      console.log(`   ${DIM}To kill this tmux session, use: tmux kill-session${RESET}`);
+      console.log('');
+      process.exit(1);
+    }
+
+    sessionName = getCurrentTmuxSessionName();
+  }
+
+  // Add ghosttown- prefix if not present
+  if (!sessionName.startsWith('ghosttown-')) {
+    sessionName = `ghosttown-${sessionName}`;
+  }
+
+  // Check if session exists
+  try {
+    const output = execSync('tmux list-sessions -F "#{session_name}"', {
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+
+    const sessions = output.split('\n').filter((s) => s.trim());
+    if (!sessions.includes(sessionName)) {
+      console.log('');
+      console.log(`   ${RED}Error:${RESET} Session '${sessionName}' not found.`);
+      console.log('');
+      console.log(`   ${BEIGE}No ghosttown sessions are currently running.${RESET}`);
+      console.log('');
+      process.exit(1);
+    }
+  } catch (err) {
+    console.log('');
+    console.log(`   ${RED}Error:${RESET} No tmux sessions found.`);
+    console.log('');
+    console.log(`   ${BEIGE}No ghosttown sessions are currently running.${RESET}`);
+    console.log('');
+    process.exit(1);
+  }
+
+  // Kill the session
+  try {
+    execSync(`tmux kill-session -t ${sessionName}`, {
+      stdio: 'pipe',
+    });
+
+    console.log('');
+    console.log(`   ${BOLD_YELLOW}Session '${sessionName}' has been killed.${RESET}`);
+    console.log('');
+    console.log(`   ${CYAN}To list remaining:${RESET}  ${BEIGE}ghosttown list${RESET}`);
+    console.log('');
+    process.exit(0);
+  } catch (err) {
+    console.log('');
+    console.log(`   ${RED}Error:${RESET} Failed to kill session '${sessionName}'.`);
+    console.log('');
+    process.exit(1);
+  }
+}
+
 // ============================================================================
 // Parse CLI arguments
 // ============================================================================
@@ -230,6 +509,7 @@ function parseArgs(argv) {
   const args = argv.slice(2);
   let port = null;
   let command = null;
+  let handled = false;
 
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
@@ -239,33 +519,71 @@ function parseArgs(argv) {
 Usage: ghosttown [options] [command]
 
 Options:
-  -p, --port <port>  Port to listen on (default: 8080, or PORT env var)
-  -h, --help         Show this help message
+  -p, --port <port>    Port to listen on (default: 8080, or PORT env var)
+  -k, --kill [session] Kill a session (current if inside one, or specify)
+  -h, --help           Show this help message
 
 Commands:
   list               List all ghosttown tmux sessions
+  attach <session>   Attach to a ghosttown session
+  detach             Detach from current ghosttown session
   <command>          Run command in a new tmux session (ghosttown-<id>)
 
 Examples:
   ghosttown                    Start the web terminal server
   ghosttown -p 3000            Start the server on port 3000
   ghosttown list               List all ghosttown sessions
+  ghosttown attach ghosttown-1 Attach to session ghosttown-1
+  ghosttown detach             Detach from current session
+  ghosttown -k                 Kill current session (when inside one)
+  ghosttown -k ghosttown-1     Kill a specific session
   ghosttown vim                Run vim in a new tmux session
   ghosttown "npm run dev"      Run npm in a new tmux session
 
 Aliases:
   This CLI can also be invoked as 'gt' or 'ght'.
 `);
-      process.exit(0);
+      handled = true;
+      break;
     }
 
     // Handle list command
     if (arg === 'list') {
+      handled = true;
       listSessions();
       // listSessions exits, so this won't be reached
     }
 
-    if (arg === '-p' || arg === '--port') {
+    // Handle detach command
+    else if (arg === 'detach') {
+      handled = true;
+      detachFromTmux();
+      // detachFromTmux exits, so this won't be reached
+    }
+
+    // Handle attach command
+    else if (arg === 'attach') {
+      const sessionArg = args[i + 1];
+      if (!sessionArg) {
+        console.error('Error: attach requires a session name');
+        console.error('Usage: ghosttown attach <session>');
+        handled = true;
+        break;
+      }
+      handled = true;
+      attachToSession(sessionArg);
+      // attachToSession exits, so this won't be reached
+    }
+
+    // Handle kill command
+    else if (arg === '-k' || arg === '--kill') {
+      const nextArg = args[i + 1];
+      // Session name is optional - if not provided or is another flag, pass null
+      const sessionArg = nextArg && !nextArg.startsWith('-') ? nextArg : null;
+      handled = true;
+      killSession(sessionArg);
+      // killSession exits, so this won't be reached
+    } else if (arg === '-p' || arg === '--port') {
       const nextArg = args[i + 1];
       if (!nextArg || nextArg.startsWith('-')) {
         console.error(`Error: ${arg} requires a port number`);
@@ -277,18 +595,17 @@ Aliases:
         process.exit(1);
       }
       i++; // Skip the next argument since we consumed it
-      continue;
     }
 
     // First non-flag argument starts the command
     // Capture it and all remaining arguments as the command
-    if (!arg.startsWith('-')) {
+    else if (!arg.startsWith('-')) {
       command = args.slice(i).join(' ');
       break;
     }
   }
 
-  return { port, command };
+  return { port, command, handled };
 }
 
 // ============================================================================
@@ -891,7 +1208,7 @@ function startWebServer(cliArgs) {
     console.log(`     ${CYAN}Home:${RESET} ${BEIGE}${homedir()}${RESET}`);
 
     console.log('');
-    console.log(`           ${DIM}Press Ctrl+C to stop.${RESET}\n`);
+    console.log(`           ${DIM}Press ctrl+c to stop.${RESET}\n`);
   }
 
   process.on('SIGINT', () => {
@@ -931,6 +1248,10 @@ function startWebServer(cliArgs) {
 export function run(argv) {
   const cliArgs = parseArgs(argv);
 
+  if (cliArgs.handled) {
+    return;
+  }
+
   // If a command is provided, create a tmux session instead of starting server
   if (cliArgs.command) {
     createTmuxSession(cliArgs.command);