zplex

A terminal multiplexer desktop app purpose-built for zpit.

Replaces scattered terminal tabs with a single Electron window — one fixed panel for zpit's TUI, plus dynamically spawned panels for each Claude Code agent.

Quick Start

Prerequisites

• Go 1.22+ (for daemon)
• Node.js 20+ (for Electron app)
• PowerShell 7+ (pwsh) — default shell for terminal sessions

Build & Run

1. Build the daemon:

   cd daemon
   go build -o zplex-daemon.exe .

2. Install and run the Electron app:

   cd app
   npm install
   npm run dev      # dev mode (Vite + Electron)
   npm run build    # production build
   npm run preview  # run Electron with production build

Architecture

Daemon/Client model (like tmux server/client):

• Go daemon — owns PTY sessions, exposes REST API + WebSocket on localhost:17732
• Electron shell — spawns the daemon, renders terminals via xterm.js
• Close the window, sessions survive. Reopen, resume instantly.

┌─────────────────────────────────────┐
│ zplex (Electron)                    │
│ ┌─────────┐ ┌──────────┐ ┌───────┐ │
│ │  zpit   │ │ Claude 1 │ │Claude2│ │
│ │ (fixed) │ │ (dynamic) │ │(dyn.) │ │
│ └─────────┘ └──────────┘ └───────┘ │
└──────────────┬──────────────────────┘
          WebSocket per panel
               │
┌──────────────▼──────────────────────┐
│ Go Daemon (port 17732)              │
│ PTY sessions + ring buffer + REST   │
└─────────────────────────────────────┘

Tech Stack

Layer	Key Packages
Go daemon	aymanbagabas/go-pty, gorilla/websocket, net/http
Electron	Electron v41, electron-builder
Frontend	@xterm/xterm v6, TypeScript, CSS Grid

License

MIT