ghostterm 1.1.3 → 1.2.0

package/CHANGELOG.md

@@ -1,8 +1,12 @@
 # Changelog
 
-## 1.1.3 (2026-03-17)
+## 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,106 @@ 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)
+  if (arg !== '--daemon') {
+    // 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 daemon
+    const { spawn } = require('child_process');
+    const out = fs.openSync(LOG_FILE, 'a');
+    const child = spawn(process.execPath, [__filename, '--daemon'], {
+      detached: true,
+      stdio: ['ignore', out, out],
+      env: { ...process.env },
+    });
+    child.unref();
+    fs.writeFileSync(PID_FILE, String(child.pid));
+    console.log('');
+    console.log(`  ✅ GhostTerm running in background (PID: ${child.pid})`);
+    console.log('  📱 Open: ghostterm.pages.dev');
+    console.log('  🛑 Stop: npx ghostterm stop');
+    console.log('  📋 Logs: npx ghostterm logs');
+    console.log('');
+    process.exit(0);
+  }
+
+  // --daemon: write PID file and continue to main()
+  fs.writeFileSync(PID_FILE, String(process.pid));
+  return 'daemon';
+}
+
 // ==================== Main ====================
 async function main() {
+  const mode = handleSubcommand();
+
   console.log('');
   console.log('  ╔═══════════════════════════════════╗');
   console.log('  ║         GhostTerm Companion        ║');
@@ -449,6 +547,26 @@ async function main() {
     console.log('  Will use pairing code instead');
   }
 
+  // First login done in foreground — now restart as daemon
+  if (mode === 'foreground-first-login' && googleToken) {
+    console.log('');
+    console.log('  Login successful! Restarting in background...');
+    const { spawn } = require('child_process');
+    const out = fs.openSync(LOG_FILE, 'a');
+    const child = spawn(process.execPath, [__filename, '--daemon'], {
+      detached: true,
+      stdio: ['ignore', out, out],
+      env: { ...process.env },
+    });
+    child.unref();
+    fs.writeFileSync(PID_FILE, String(child.pid));
+    console.log(`  ✅ GhostTerm running in background (PID: ${child.pid})`);
+    console.log('  📱 Open: ghostterm.pages.dev');
+    console.log('  🛑 Stop: npx ghostterm stop');
+    console.log('');
+    process.exit(0);
+  }
+
   connectToRelay();
 }
 

package/package.json

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