ghostterm 2.2.0 → 2.2.2

package/README.md

@@ -1,4 +1,13 @@
-# GhostTerm — Control Claude Code from Your Phone
+<p align="center">
+  <img src="https://ghostterm.pages.dev/img/banner.png" alt="GhostTerm" width="400">
+</p>
+
+<h1 align="center">GhostTerm</h1>
+<p align="center"><strong>Control Claude Code from Your Phone</strong></p>
+<p align="center">
+  <a href="https://www.npmjs.com/package/ghostterm"><img src="https://img.shields.io/npm/v/ghostterm.svg" alt="npm version"></a>
+  <a href="https://ghostterm.pages.dev"><img src="https://img.shields.io/badge/mobile-ghostterm.pages.dev-8b5cf6" alt="Mobile App"></a>
+</p>
 
 > **v2.0: Complete P2P Rewrite** — Your terminal data never touches any server. Direct encrypted connection between your phone and PC.
 
@@ -26,13 +35,12 @@ Run up to **4 concurrent terminal sessions** with ghost cell tabs. Have Claude C
 
 A unique animated workspace shows all your terminal sessions as pixel ghosts. See which ones are busy, idle, or waiting for input — **without switching tabs**. Know exactly what's happening on your PC from a single screen.
 
-### True End-to-End Encryption
+### Encrypted Direct Connection
 
-Your terminal data travels directly between your phone and PC over **WebRTC with DTLS encryption**. The signaling server only handles the initial pairing handshake — it never sees your terminal data. Not even GhostTerm's servers can read what you type.
+The remote control link between your phone and PC is a **direct WebRTC connection with DTLS encryption**. Your keystrokes and terminal output travel straight between devices — they never pass through GhostTerm's servers or any third party.
 
-Compare:
-- **Official app**: Your data → Anthropic's servers → Your PC
-- **GhostTerm**: Your phone ↔ Your PC (direct, encrypted, no middleman)
+- **How it works**: Phone ↔ PC direct (the signaling server only helps with pairing, then gets out of the way)
+- **What's encrypted**: Everything you see and type in the remote terminal session
 
 ### Send Files from Phone to PC
 
@@ -48,14 +56,21 @@ Purpose-built buttons for Claude Code workflows:
 
 ## Quick Start
 
+**Install once:**
 ```bash
-npx ghostterm
+npm install -g ghostterm
 ```
 
-1. Run the command above on your PC (requires [Node.js 18+](https://nodejs.org))
-2. First time: browser opens for Google sign-in (one-time, remembered after)
-3. Open **[ghostterm.pages.dev](https://ghostterm.pages.dev)** on your phone
-4. Sign in with the same Google account → **auto-connects, no pairing codes**
+**Then just run:**
+```bash
+ghostterm
+```
+
+1. First time: browser opens for Google sign-in (one-time, remembered after)
+2. Open **[ghostterm.pages.dev](https://ghostterm.pages.dev)** on your phone
+3. Sign in with the same Google account → **auto-connects, no pairing codes**
+
+> Don't want to install? Use `npx ghostterm` to run without installing.
 
 ## Security
 

package/lib/pty-manager.js

@@ -269,11 +269,15 @@ class PtyManager extends EventEmitter {
       }
 
       case 'file-upload': {
-        // Handle file upload: write base64 content to temp file
         this._handleFileUpload(msg, responses);
         break;
       }
 
+      case 'file-chunk': {
+        this._handleFileChunk(msg, responses);
+        break;
+      }
+
       default:
         break;
     }
@@ -315,6 +319,30 @@ class PtyManager extends EventEmitter {
     }
   }
 
+  _handleFileChunk(msg, responses) {
+    if (!this._fileChunks) this._fileChunks = {};
+    const key = msg.filename;
+    if (!this._fileChunks[key]) {
+      this._fileChunks[key] = { chunks: [], total: msg.total, ext: msg.ext, size: msg.size };
+    }
+    const entry = this._fileChunks[key];
+    entry.chunks[msg.index] = msg.chunk;
+
+    // Check if all chunks received
+    const received = entry.chunks.filter(Boolean).length;
+    if (received === entry.total) {
+      // Reassemble
+      const fullBase64 = entry.chunks.join('');
+      delete this._fileChunks[key];
+      this._handleFileUpload({
+        data: fullBase64,
+        filename: msg.filename,
+        ext: entry.ext,
+        size: entry.size,
+      }, responses);
+    }
+  }
+
   _sessionList() {
     const list = [];
     for (const [id, session] of this.sessions) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ghostterm",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "Control your PC terminal from your phone — direct P2P, no server in between",
   "bin": {
     "ghostterm": "bin/ghostterm-p2p.js"
@@ -20,7 +20,7 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "license": "UNLICENSED",
+  "license": "MIT",
   "homepage": "https://ghostterm.pages.dev",
   "keywords": [
     "terminal",