wolfpack-bridge 1.5.0 → 1.5.2

package/README.md

@@ -4,6 +4,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey.svg)]()
 [![Version](https://img.shields.io/github/v/release/almogdepaz/wolfpack?label=version)](https://github.com/almogdepaz/wolfpack/releases)
+[![GitHub stars](https://img.shields.io/github/stars/almogdepaz/wolfpack?style=social)](https://github.com/almogdepaz/wolfpack/stargazers)
 
 ```
         ...:.
@@ -17,7 +18,7 @@
      -.  ..     -++++***#**++*#*--:---===:
      -.:--==+=--=*++*+**********+==------++-
      .:----=++*++##########******+=====--=+#=-.
-       .::-----=++*#%%%%%%#***###*+===--==+*=++=:.
+       .::-----=+*#%%%%%%#***###*+===--==+*=++=:.
          ...::::-=+*#%%############*+-----===+****+=:.
           :--=-====+******++****##***-.::--++*######**
          .++-+++++***********#*+*#***=.:---=+**=--=+==
@@ -38,11 +39,19 @@ Mobile & desktop command center for AI coding agents. Control tmux-based session
 
 Install on your phone's home screen for a native app experience — scan the QR code after setup and tap **"Add to Home Screen"**.
 
+### Desktop
 <p align="center">
-  <img src="docs/desktop-demo.gif" width="700" alt="Desktop — sessions, terminal, and settings views" />
+  <img src="docs/desktop-terminal.png" width="700" alt="Desktop — terminal with collapsible sidebar" />
 </p>
 <p align="center">
-  <img src="docs/mobile-demo.gif" width="300" alt="Mobile — sessions, terminal, and settings views" />
+  <img src="docs/desktop-grid.png" width="700" alt="Desktop — multi-terminal grid view" />
+</p>
+
+### Mobile
+
+<p align="center">
+  <img src="docs/mobile-sessions.png" width="300" alt="Mobile — session list with multi-machine support" />
+  <img src="docs/mobile-terminal.png" width="300" alt="Mobile — live terminal view" />
 </p>
 
 ## Architecture
@@ -92,6 +101,16 @@ Supported platforms: macOS (Apple Silicon, Intel), Linux (x64, arm64).
 - **tmux**
 - **Tailscale** — install from [tailscale.com/download](https://tailscale.com/download), sign in, and make sure both your computer and phone are on the same tailnet
 
+### tmux History
+
+Wolfpack can only hydrate history that tmux still retains. Desktop terminal sessions prefill the latest 5,000 lines on connect, so if you want deeper scrollback, raise tmux's history limit:
+
+```tmux
+set -g history-limit 50000
+```
+
+Reload tmux or restart your sessions after changing it.
+
 ## Usage
 
 ```bash
@@ -118,15 +137,39 @@ On first run, `wolfpack` walks you through:
 
 ## Features
 
-- **Session management** — create, view, and kill tmux agent sessions
-- **Live terminal** — capture-pane polling for real-time terminal view (mobile), xterm.js PTY for desktop
-- **Agent picker** — choose Claude, Codex, Gemini, or custom commands per session
-- **Multi-machine** — one phone connects to multiple Wolfpack servers; sessions grouped by machine
+### Session Management
+- Create, view, and kill tmux agent sessions
+- Agent picker — Claude, Codex, Gemini, or custom commands per session
+- Session triage — running, idle, and needs-input states with color-coded indicators
+- Live terminal output preview on session cards
+
+### Desktop
+- **Multi-terminal grid** — view 2-6 sessions side-by-side in a CSS grid layout. Click `+` on any sidebar card to add it to the grid, `×` to remove. Focused cell highlighted with green glow.
+- **Collapsible sidebar** — pin or auto-hide. Shows all sessions across machines with status badges, output preview, and grid/kill buttons.
+- **xterm.js PTY** — full terminal emulator with direct PTY connection (not capture-pane polling)
+- **Keyboard shortcuts:**
+  - `Cmd/Ctrl + ArrowUp/Down` — cycle between sessions
+  - `Cmd/Ctrl + ArrowLeft/Right` — navigate grid cells
+  - `Cmd/Ctrl + T` — new session (project picker)
+  - `Cmd/Ctrl + K` — clear terminal
+
+### Mobile
+- **Capture-pane polling** — real-time terminal view optimized for mobile
+- **Swipe gestures** — swipe between sessions and views
+- **Haptic feedback** — vibration on key actions
+- **PWA** — install as a standalone app on your phone's home screen
+
+### Multi-Machine
+- One phone connects to multiple Wolfpack servers
+- Sessions grouped by machine with online/offline status
+- Auto-discover Tailscale peers running Wolfpack
+- Cross-machine session management from a single UI
+
+### Other
 - **Notifications** — browser notifications + vibration when sessions need attention
 - **Search** — find text in terminal output with match navigation
-- **PWA** — install as a standalone app on your phone's home screen
 - **Reconnect handling** — auto-recovers on connection drop with status indicator
-- **Auto-resize** — tmux pane resizes to match your screen
+- **Auto-resize** — terminal resizes to match your screen/grid cell
 
 ### Remote Access
 
@@ -138,13 +181,6 @@ On first run, `wolfpack` walks you through:
 
 Tailscale's encrypted mesh network handles auth and routing — no ports to open, no DNS to configure.
 
-### Multi-Machine
-
-1. Install Wolfpack on each machine (`bunx wolfpack-bridge` or `curl` install)
-2. Ensure all machines and your phone share a Tailscale network
-3. On your phone: **Settings → Add Machine** → scan QR or paste URL
-4. Sessions from all machines appear in a single grouped view
-
 ## Ralph Loop
 
 Autonomous task runner. Write a markdown plan file, pick an agent, set iterations, and let it rip. Ralph reads the plan, extracts the first incomplete task, hands it to the agent, marks it done, and moves on — implementing, testing, and committing along the way. See [full documentation](docs/ralph-macchio.md).
@@ -186,7 +222,7 @@ bun test tests/unit/plan-parsing.test.ts  # single file
 ```
 
 Tests use Bun's built-in runner. Three categories:
-- `tests/unit/` — plan parsing, ralph log parsing, escaping, validation
+- `tests/unit/` — plan parsing, ralph log parsing, escaping, validation, grid logic
 - `tests/snapshot/` — launchd plist and systemd unit generation
 - `tests/integration/` — API routes, ralph loop endpoints
 
@@ -212,6 +248,12 @@ Compiles for: linux-x64, linux-arm64, darwin-x64, darwin-arm64.
 - Tests must pass (`bun test`)
 - Keep PRs focused — one feature or fix per PR
 
+## Community & Support
+
+- 💬 [Open a Discussion](https://github.com/almogdepaz/wolfpack/discussions) — questions, ideas, show & tell
+- 🐛 [File an Issue](https://github.com/almogdepaz/wolfpack/issues) — bugs and feature requests
+- ⭐ **Star the repo** if Wolfpack saves you time — it helps others find it
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfpack-bridge",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "type": "module",
   "description": "Mobile command center for tmux-based AI agent sessions",
   "bin": {
@@ -17,10 +17,10 @@
     "postinstall": "node bin/install.cjs"
   },
   "optionalDependencies": {
-    "wolfpack-bridge-darwin-arm64": "1.5.0",
-    "wolfpack-bridge-darwin-x64": "1.5.0",
-    "wolfpack-bridge-linux-arm64": "1.5.0",
-    "wolfpack-bridge-linux-x64": "1.5.0"
+    "wolfpack-bridge-darwin-arm64": "1.5.2",
+    "wolfpack-bridge-darwin-x64": "1.5.2",
+    "wolfpack-bridge-linux-arm64": "1.5.2",
+    "wolfpack-bridge-linux-x64": "1.5.2"
   },
   "keywords": [
     "tmux",
@@ -41,6 +41,8 @@
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/addon-search": "^0.16.0",
     "@xterm/addon-unicode11": "^0.9.0",
+    "@xterm/addon-web-links": "^0.12.0",
+    "@xterm/addon-webgl": "^0.19.0",
     "@xterm/xterm": "^6.0.0",
     "qrcode-terminal": "^0.12.0",
     "ws": "^8.19.0"