PairUX

---

✨ Features

• 🖥️ Real-time screen sharing — Low-latency WebRTC streaming
• 🎮 Remote control — Mouse + keyboard with explicit host approval. Two independent cursors: the guest's movement never takes over yours
• 👥 Simultaneous input — Host and viewer can control at the same time
• 🔒 Secure by design — E2E encrypted, media never touches servers
• 🌐 PWA Viewer — Join sessions from any browser, installable as an app
• 💻 Cross-platform — macOS, Windows, Linux desktop apps
• 📦 Easy install — Available via Homebrew, WinGet, APT, and more

---

🚀 Quick Start

Install the Desktop App (Host)

One line (macOS / Linux) — installs the app and the pairux command under ~/.pairux and ~/.local:

curl -fsSL https://pairux.com/install.sh | sh

Homebrew (Recommended)

brew tap profullstack/homebrew-pairux
brew install --cask pairux

Direct Download

• PairUX-x.x.x-arm64.dmg (Apple Silicon)
• PairUX-x.x.x-x64.dmg (Intel)

WinGet (Recommended)

winget install PairUX.PairUX

Scoop

scoop bucket add pairux https://github.com/profullstack/scoop-pairux
scoop install pairux

Chocolatey

choco install pairux

Direct Download

• PairUX-x.x.x-x64.exe

APT Repository (Recommended)

# Add GPG key
curl -fsSL https://profullstack.github.io/pairux-apt/pairux.gpg | sudo gpg --dearmor -o /usr/share/keyrings/pairux.gpg

# Add repository
echo "deb [signed-by=/usr/share/keyrings/pairux.gpg] https://profullstack.github.io/pairux-apt stable main" | sudo tee /etc/apt/sources.list.d/pairux.list

# Install
sudo apt update && sudo apt install pairux

Direct Download

• pairux_x.x.x_amd64.deb

RPM Repository (Recommended)

# Add repository
sudo dnf config-manager --add-repo https://profullstack.github.io/pairux-rpm/pairux.repo

# Import GPG key
sudo rpm --import https://profullstack.github.io/pairux-rpm/RPM-GPG-KEY-pairux

# Install
sudo dnf install pairux

Direct Download

• pairux-x.x.x-1.x86_64.rpm

AUR (Recommended)

# Using yay
yay -S pairux-bin

# Using paru
paru -S pairux-bin

# Manual
git clone https://aur.archlinux.org/pairux-bin.git
cd pairux-bin
makepkg -si

Custom Overlay

# Add overlay
sudo eselect repository add pairux git https://github.com/profullstack/gentoo-pairux.git
sudo emaint sync -r pairux

# Install
sudo emerge net-misc/pairux-bin

Flake (Recommended)

nix profile install github:profullstack/pairux-nix

nix-shell

nix-shell -p pairux

AppImage

# Download
wget https://github.com/profullstack/pairux.com/releases/latest/download/PairUX-x.x.x-x86_64.AppImage

# Make executable
chmod +x PairUX-*.AppImage

# Run
./PairUX-*.AppImage

CLI Usage

Once installed, the pairux command is available in your terminal:

pairux                # Launch the desktop app
pairux update         # Check for updates and install the latest version
pairux uninstall      # Remove PairUX completely
pairux --version      # Show installed version
pairux --help         # Show help

The same command brings an AI agent (Claude Code, moshcode, a script) into a live session as a labelled participant that follows and posts in the chat. See pairux.com/docs/agents.

pairux login                     # Optional: label your agents as yours (browser sign-in)
pairux join ABC123 --name Claude # Join with the session's join code
pairux listen --json             # Follow chat and who is here; keeps the agent present
pairux say "Tests pass"          # Post in the chat
pairux voice join --json         # Hear call audio; stdin speaks through C0mpute TTS
pairux who                       # Who is in the session
pairux leave

Join as a Viewer (No Install Required!)

Just open the session link in any modern browser. The viewer is a Progressive Web App (PWA) — you can install it for quick access without downloading anything.

---

🎯 How It Works

┌─────────────────┐                      ┌─────────────────┐
│   Host          │                      │   Viewer        │
│   (Desktop App) │◄────── WebRTC ──────►│   (PWA/Browser) │
│                 │        P2P           │                 │
│   Shares screen │                      │   Views screen  │
│   Grants control│                      │   Requests ctrl │
└─────────────────┘                      └─────────────────┘
         │                                        │
         │         Auth + Signaling only          │
         └──────────────┬─────────────────────────┘
                        ▼
               ┌─────────────────┐
               │    Supabase     │
               │  (No media!)    │
               └─────────────────┘

1. Host starts a session in the desktop app
2. Host shares the join link with a viewer
3. Viewer opens the link in their browser (or installed PWA)
4. WebRTC establishes a direct P2P connection
5. Viewer can request control, Host approves
6. Both can control simultaneously — Host always has priority

---

This is the beginning of the README. Read the rest at the original. Read the full README ↗