ghostterm 1.0.4 → 1.1.1

package/README.md

@@ -9,15 +9,17 @@
 ## Screenshots
 
 <p align="center">
-  <img src="https://ghostterm.pages.dev/img/claude-code.jpg" width="250" alt="Claude Code running on phone">
-  <img src="https://ghostterm.pages.dev/img/terminal.jpg" width="250" alt="Terminal with dangerous mode">
-  <img src="https://ghostterm.pages.dev/img/pixel-office.jpg" width="250" alt="4 terminal sessions">
+  <img src="https://ghostterm.pages.dev/img/banner.png" width="500" alt="GhostTerm Banner">
 </p>
 
 <p align="center">
-  <em>Left: Claude Code with <code>--dangerously-skip-permissions</code> running on your phone</em><br>
-  <em>Center: Full terminal + custom shortcut keys (y/n, Tab, Ctrl+C, arrows...)</em><br>
-  <em>Right: 4 ghost terminals in pixel office view</em>
+  <img src="https://ghostterm.pages.dev/img/office-busy.jpg" width="220" alt="Ghosts working">
+  <img src="https://ghostterm.pages.dev/img/pixel-office.jpg" width="220" alt="Pixel office overview">
+  <img src="https://ghostterm.pages.dev/img/claude-code.jpg" width="220" alt="Claude Code on phone">
+</p>
+
+<p align="center">
+  <em>Halloween-themed pixel office · 4 animated ghost terminals · Claude Code on your phone</em>
 </p>
 
 ---
@@ -84,6 +86,20 @@ Take a screenshot of your phone screen and send it to your PC terminal. Upload f
 | No VPN needed | ✅ | N/A |
 | Google auto-pairing | ✅ | - |
 
+## Controls
+
+**Top bar**: 4 ghost cells (tap to switch terminals, `+` to create new) · `🏠` pixel office view · `A` font size · `▼` hide controls
+
+**Quick keys**: `y` / `n` (approve/deny) · `S+Tab` (shift-tab) · `/ cmd` (slash commands) · `Tab` · `←Bksp`
+
+**Left column**: `⏻ claude` (launch menu: new / resume / continue / dangerous mode) · `Stop` (Ctrl+C) · `Close` (kill session)
+
+**Center**: D-pad (↑↓←→) + `Enter`
+
+**Right column**: `Line↵` (newline) · `⬇` (scroll to bottom) · `Space` · `▲▼` (page up/down) · `Copy` (select mode)
+
+**Bottom**: Text input + `Send` · `📷 Shot` (screenshot to PC) · `📁 File` (upload to PC)
+
 ## Pricing
 
 - **Free**: 1 hour/day, full features

package/bin/ghostterm.js

@@ -37,11 +37,23 @@ function loadToken() {
     if (fs.existsSync(CRED_FILE)) {
       const cred = JSON.parse(fs.readFileSync(CRED_FILE, 'utf8'));
       if (cred.id_token) {
-        const payload = JSON.parse(Buffer.from(cred.id_token.split('.')[1], 'base64').toString());
-        if (payload.exp * 1000 > Date.now()) {
-          return cred.id_token;
+        // Long token format: base64payload.signature (no dots in payload)
+        const parts = cred.id_token.split('.');
+        if (parts.length === 2) {
+          // Long token — check our own expiry
+          try {
+            const data = JSON.parse(Buffer.from(parts[0], 'base64').toString());
+            if (data.exp > Date.now()) return cred.id_token;
+            console.log('  Long token expired, need to re-login');
+          } catch {}
+        } else if (parts.length === 3) {
+          // Google JWT — check Google expiry
+          try {
+            const payload = JSON.parse(Buffer.from(parts[1], 'base64').toString());
+            if (payload.exp * 1000 > Date.now()) return cred.id_token;
+            console.log('  Google token expired, need to re-login');
+          } catch {}
         }
-        console.log('  Token expired, need to re-login');
       }
     }
   } catch {}
@@ -175,20 +187,28 @@ function createSession() {
 
   console.log(`  Terminal ${id} spawned (PID: ${term.pid})`);
 
+  function flushOutput() {
+    if (session.pendingData) {
+      sendToRelay({ type: 'output', data: session.pendingData, seq: session.bufferSeq, id });
+      session.pendingData = '';
+    }
+    session.flushTimer = null;
+  }
+
   term.onData((data) => {
     session.outputBuffer += data;
     session.bufferSeq += data.length;
     if (session.outputBuffer.length > OUTPUT_BUFFER_MAX) {
       session.outputBuffer = session.outputBuffer.slice(-OUTPUT_BUFFER_MAX);
     }
-    // Batch output: accumulate for 12ms then flush once
     session.pendingData += data;
-    if (!session.flushTimer) {
-      session.flushTimer = setTimeout(() => {
-        sendToRelay({ type: 'output', data: session.pendingData, seq: session.bufferSeq, id });
-        session.pendingData = '';
-        session.flushTimer = null;
-      }, 12);
+    // Adaptive: small output (keystroke echo) → flush immediately
+    // Large output (bulk) → batch for 8ms
+    if (session.pendingData.length < 64) {
+      if (session.flushTimer) { clearTimeout(session.flushTimer); session.flushTimer = null; }
+      flushOutput();
+    } else if (!session.flushTimer) {
+      session.flushTimer = setTimeout(flushOutput, 8);
     }
   });
 
@@ -208,6 +228,34 @@ function getSessionList() {
   return Array.from(sessions.values()).map(s => ({ id: s.id, exited: s.exited }));
 }
 
+// ==================== Standby Session (pre-spawn for instant open) ====================
+let standbySession = null;
+
+function prepareStandby() {
+  // Only prepare if under max and no standby exists
+  if (standbySession || sessions.size >= MAX_SESSIONS) return;
+  standbySession = createSession();
+  // Remove from active sessions — it's hidden until needed
+  sessions.delete(standbySession.id);
+  console.log(`  Standby terminal ${standbySession.id} ready`);
+}
+
+function useStandbyOrCreate() {
+  let s;
+  if (standbySession && !standbySession.exited) {
+    s = standbySession;
+    sessions.set(s.id, s);
+    standbySession = null;
+    console.log(`  Using standby terminal ${s.id}`);
+  } else {
+    standbySession = null;
+    s = createSession();
+  }
+  // Prepare next standby after a short delay
+  setTimeout(() => prepareStandby(), 1000);
+  return s;
+}
+
 // ==================== Relay Connection ====================
 let relayWs = null;
 let pairCode = null;
@@ -267,6 +315,13 @@ function handleRelayMessage(msg) {
     case 'auth_ok':
       console.log(`  Authenticated as: ${msg.email}`);
       console.log('  Phone will auto-connect with same Google account');
+      // Save long token if provided (valid 30 days, no more Google expiry issues)
+      if (msg.longToken) {
+        saveToken(msg.longToken);
+        googleToken = msg.longToken;
+        console.log('  Long-lived token saved (30 days)');
+      }
+      prepareStandby();
       break;
 
     case 'auth_error':
@@ -283,10 +338,16 @@ function handleRelayMessage(msg) {
 
     case 'mobile_connected':
       console.log('  Mobile connected!');
-      if (sessions.size === 0) createSession();
-      sendToRelay({ type: 'sessions', list: getSessionList() });
-      const first = sessions.values().next().value;
-      if (first) sendToRelay({ type: 'attached', id: first.id });
+      if (sessions.size === 0) {
+        // Use standby session if available, otherwise create new
+        const s = useStandbyOrCreate();
+        sendToRelay({ type: 'sessions', list: getSessionList() });
+        sendToRelay({ type: 'attached', id: s.id });
+      } else {
+        sendToRelay({ type: 'sessions', list: getSessionList() });
+        const first = sessions.values().next().value;
+        if (first) sendToRelay({ type: 'attached', id: first.id });
+      }
       break;
 
     case 'mobile_disconnected':
@@ -311,7 +372,7 @@ function handleRelayMessage(msg) {
 
     case 'create-session':
       if (sessions.size < MAX_SESSIONS) {
-        const session = createSession();
+        const session = useStandbyOrCreate();
         sendToRelay({ type: 'sessions', list: getSessionList() });
         sendToRelay({ type: 'attached', id: session.id });
       } else {

package/package.json

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