ghostterm 1.0.4 → 1.1.0

package/README.md

@@ -84,6 +84,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

@@ -175,20 +175,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 +216,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 +303,8 @@ function handleRelayMessage(msg) {
     case 'auth_ok':
       console.log(`  Authenticated as: ${msg.email}`);
       console.log('  Phone will auto-connect with same Google account');
+      // Pre-spawn a standby terminal so first open is instant
+      prepareStandby();
       break;
 
     case 'auth_error':
@@ -283,10 +321,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 +355,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.0",
   "description": "Mobile terminal for Claude Code — control your PC from your phone",
   "bin": {
     "ghostterm": "bin/ghostterm.js"