ghostterm 1.1.3 → 1.2.1

package/CHANGELOG.md

@@ -1,8 +1,18 @@
 # Changelog
 
-## 1.1.3 (2026-03-17)
+## 1.2.1 (2026-03-17)
+
+### Bug Fixes
+- **Windows background mode** — fixed node-pty crash in detached mode by using `windowsHide` instead of raw detach
+- **Supervisor crash loop** — fixed `--supervisor` arg being caught by "already running" check
+
+## 1.2.0 (2026-03-17)
 
 ### Features
+- **Background mode by default** — `npx ghostterm` now runs in the background automatically, no terminal window
+- **CLI commands** — `npx ghostterm stop`, `npx ghostterm status`, `npx ghostterm logs`
+- **First-run login** — opens browser for Google sign-in in foreground, then auto-restarts as daemon
+- **Duplicate detection** — prevents starting multiple instances
 - **12345 numpad popup** — quick number selection for CLI surveys/prompts (raw keypress without Enter)
 - **Screen button** — renamed from "Shot" for clarity
 - **Paste button shows filename** — after uploading, displays shortened filename instead of generic "Paste"

package/README.md

@@ -38,13 +38,22 @@ No VPN. No Tailscale. No port forwarding. Just one command.
 npx ghostterm
 ```
 
-First run opens a browser for Google sign-in. After that, it remembers you.
+First run opens a browser for Google sign-in. After that, it runs in the background automatically — no terminal window.
 
-**Run in background (no terminal window):**
+```
+$ npx ghostterm
+  ✅ GhostTerm running in background (PID: 12345)
+  📱 Open: ghostterm.pages.dev
+  🛑 Stop: npx ghostterm stop
+  📋 Logs: npx ghostterm logs
+```
+
+Other commands:
 
 ```bash
-pm2 start ghostterm.js --name ghostterm
-pm2 save
+npx ghostterm status   # check if running
+npx ghostterm stop     # stop the background process
+npx ghostterm logs     # show recent logs
 ```
 
 ### 2. On your phone

package/bin/ghostterm.js

@@ -433,8 +433,150 @@ function handleRelayMessage(msg) {
   }
 }
 
+// ==================== Background Mode ====================
+const PID_FILE = path.join(CRED_DIR, 'ghostterm.pid');
+const LOG_FILE = path.join(CRED_DIR, 'ghostterm.log');
+
+function isRunning(pid) {
+  try { process.kill(pid, 0); return true; } catch { return false; }
+}
+
+function handleSubcommand() {
+  const arg = process.argv[2];
+
+  if (arg === 'stop') {
+    if (fs.existsSync(PID_FILE)) {
+      const pid = parseInt(fs.readFileSync(PID_FILE, 'utf8'));
+      if (isRunning(pid)) {
+        process.kill(pid);
+        fs.unlinkSync(PID_FILE);
+        console.log(`  GhostTerm stopped (PID: ${pid})`);
+      } else {
+        fs.unlinkSync(PID_FILE);
+        console.log('  GhostTerm was not running');
+      }
+    } else {
+      console.log('  GhostTerm is not running');
+    }
+    process.exit(0);
+  }
+
+  if (arg === 'status') {
+    if (fs.existsSync(PID_FILE)) {
+      const pid = parseInt(fs.readFileSync(PID_FILE, 'utf8'));
+      if (isRunning(pid)) {
+        console.log(`  GhostTerm is running (PID: ${pid})`);
+      } else {
+        fs.unlinkSync(PID_FILE);
+        console.log('  GhostTerm is not running');
+      }
+    } else {
+      console.log('  GhostTerm is not running');
+    }
+    process.exit(0);
+  }
+
+  if (arg === 'logs') {
+    if (fs.existsSync(LOG_FILE)) {
+      const lines = fs.readFileSync(LOG_FILE, 'utf8').split('\n').slice(-50);
+      console.log(lines.join('\n'));
+    } else {
+      console.log('  No logs found');
+    }
+    process.exit(0);
+  }
+
+  // No subcommand = start in background (unless already daemonized via --daemon or --supervisor)
+  if (arg !== '--daemon' && arg !== '--supervisor') {
+    // Check if already running
+    if (fs.existsSync(PID_FILE)) {
+      const pid = parseInt(fs.readFileSync(PID_FILE, 'utf8'));
+      if (isRunning(pid)) {
+        console.log(`  GhostTerm is already running (PID: ${pid})`);
+        console.log('  Stop: npx ghostterm stop');
+        process.exit(0);
+      }
+    }
+
+    // First-time login needs foreground (browser opens)
+    const needsLogin = !fs.existsSync(CRED_FILE);
+    if (needsLogin) {
+      // Run in foreground for first login, then restart as daemon
+      return 'foreground-first-login';
+    }
+
+    // Spawn self as supervisor in background
+    const { spawn, execSync } = require('child_process');
+    const out = fs.openSync(LOG_FILE, 'a');
+
+    if (os.platform() === 'win32') {
+      // Windows: spawn with hidden window (windowsHide) but NOT detached
+      // node-pty requires a console; detached:true removes the console and crashes
+      // windowsHide:true creates a hidden console window
+      const child = spawn(process.execPath, [__filename, '--supervisor'], {
+        detached: true,
+        windowsHide: true,
+        stdio: ['ignore', out, out],
+        env: { ...process.env },
+      });
+      child.unref();
+      fs.writeFileSync(PID_FILE, String(child.pid));
+    } else {
+      // macOS/Linux: detached works fine
+      const child = spawn(process.execPath, [__filename, '--supervisor'], {
+        detached: true,
+        stdio: ['ignore', out, out],
+        env: { ...process.env },
+      });
+      child.unref();
+      fs.writeFileSync(PID_FILE, String(child.pid));
+    }
+    const pid = fs.existsSync(PID_FILE) ? fs.readFileSync(PID_FILE, 'utf8').trim() : '?';
+    console.log('');
+    console.log(`  ✅ GhostTerm running in background (PID: ${pid})`);
+    console.log('  📱 Open: ghostterm.pages.dev');
+    console.log('  🛑 Stop: npx ghostterm stop');
+    console.log('  📋 Logs: npx ghostterm logs');
+    console.log('');
+    process.exit(0);
+  }
+
+  // --supervisor: watchdog that restarts worker on crash
+  if (arg === '--supervisor') {
+    fs.writeFileSync(PID_FILE, String(process.pid));
+    const { spawn } = require('child_process');
+    let restartCount = 0;
+
+    function spawnWorker() {
+      const logFd = fs.openSync(LOG_FILE, 'a');
+      const worker = spawn(process.execPath, [__filename, '--daemon'], {
+        stdio: ['ignore', logFd, logFd],
+        env: { ...process.env },
+      });
+      worker.on('exit', (code) => {
+        if (code === 0) {
+          // Clean exit (e.g. from stop command), don't restart
+          process.exit(0);
+        }
+        restartCount++;
+        const delay = Math.min(restartCount * 3000, 30000); // 3s, 6s, 9s... max 30s
+        console.log(`  [supervisor] Worker exited (code ${code}), restarting in ${delay / 1000}s... (restart #${restartCount})`);
+        setTimeout(spawnWorker, delay);
+      });
+    }
+
+    spawnWorker();
+    return;
+  }
+
+  // --daemon: write PID file and continue to main()
+  return 'daemon';
+}
+
 // ==================== Main ====================
 async function main() {
+  const mode = handleSubcommand();
+
   console.log('');
   console.log('  ╔═══════════════════════════════════╗');
   console.log('  ║         GhostTerm Companion        ║');
@@ -449,6 +591,16 @@ async function main() {
     console.log('  Will use pairing code instead');
   }
 
+  // First login done in foreground — now restart in background
+  if (mode === 'foreground-first-login' && googleToken) {
+    console.log('');
+    console.log('  Login successful! Starting in background...');
+    // Re-run ourselves which will take the normal background start path
+    const { execSync } = require('child_process');
+    execSync(`"${process.execPath}" "${__filename}"`, { stdio: 'inherit' });
+    process.exit(0);
+  }
+
   connectToRelay();
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ghostterm",
-  "version": "1.1.3",
+  "version": "1.2.1",
   "description": "Mobile terminal for Claude Code — control your PC from your phone",
   "bin": {
     "ghostterm": "bin/ghostterm.js"