Skip to content

Repository files navigation

SuperPlexr — mission control for coding agents

A GPUI experiment in native agent multiplexing.
Run coding agents in parallel. Keep every terminal, decision, and result in one durable workspace.

CI MIT license Rust and GPUI macOS and Linux

SuperPlexr native desktop switching between its terminal waterfall, command deck, and focus mode

SuperPlexr is an experimental desktop app built with Rust and GPUI for launching, supervising, and reviewing multiple terminal-based coding agents. Think tmux for agent work, with Missions, attention, durable state, and verification built in.

This is a GPUI experiment and source preview, with rough edges and ongoing changes.

Why SuperPlexr

Parallel-agent problem SuperPlexr
Too many terminal windows One Mission with a Session sidebar and terminal waterfall
Hidden blockers Waiting and attention states stay visible
Lost work after closing a window Runtime-owned PTYs and deterministic reattach
Competing attempts Run graph, candidates, evidence, and review
Unclear control Explicit human and agent Control leases

Use named engine drivers to connect the coding-agent CLIs you already run. SuperPlexr stays local by default and does not require a cloud service.

Native desktop

  • Mission tabs organize work by outcome.
  • Session sidebar shows working, waiting, idle, and finished agents.
  • Terminal waterfall keeps several live terminals visible.
  • Command deck makes navigation and actions keyboard-first.
  • Focus mode expands one Session without losing its Mission context.
  • Review flow connects candidates, checks, evidence, and decisions.
SuperPlexr command deck over the native desktop
Command deck
SuperPlexr focus mode showing one agent review terminal
Focus mode

Run it

Experimental binaries for macOS and Linux (x86-64 and ARM64) are published by the release action. Each platform archive contains all eight executables; macOS also has an app bundle. See Releases for available builds and release notes for requirements and limitations.

SuperPlexr 0.1.0 is a source preview. The macOS build is usable today. Linux desktop code is present, with Wayland, X11, and packaging release gates still open.

Requirements: macOS 13+ or Linux development libraries, Rust 1.97.1, and Zig 0.16.0 for the pinned Ghostty dependency.

git clone https://github.com/debpalash/superplexr.git
cd superplexr
cargo run -p superplexr-desktop

The desktop starts its local runtime automatically and reconnects to durable Sessions when reopened.

Action macOS Linux
Command deck Cmd+K Ctrl+K
Next attention Cmd+Shift+A Ctrl+Shift+A
New Mission Cmd+T Ctrl+Shift+T
New Session Cmd+N Ctrl+Shift+N
Focus mode Cmd+Shift+Enter Ctrl+Shift+Enter

How it works

flowchart LR
    A[Coding-agent CLIs] --> R[Local runtime]
    D[Native GPUI desktop] <--> R
    R --> P[Durable PTYs]
    R --> M[Missions and Runs]
    R --> E[History and evidence]
Loading

The runtime owns processes and state. The desktop can restart without killing agent work. CLI, TUI, MCP, browser observer, and remote clients use the same runtime.

cargo run -p superplexr-cli -- list
cargo run -p superplexr-cli -- status
cargo run -p superplexr-cli -- launch "Ship the release" \
  --task "Fix the failing tests" --task "Review the README" --checkout
cargo run -p superplexr-cli -- attention
cargo run -p superplexr-cli -- terminal-text "$SESSION_ID"
cargo run -p superplexr-cli -- terminal-wait-exit "$SESSION_ID" --compact
cargo run -p superplexr-cli -- mission-brief "$MISSION_ID"
cargo run -p superplexr-cli -- doctor

launch creates a Mission and starts each explicit task through its configured engine. attention, terminal-text, compact waits, and mission-brief keep agent reads short. doctor reports bounded cache usage and cleans only the workspace build cache when asked.

Browser observer preview

The browser observer is a scoped secondary client for watching or sharing a Session.

SuperPlexr browser observer switching and searching durable sessions

Release status

Area State
macOS source build Usable preview
Linux source Implemented; native release validation open
Signed installers Not published
Production readiness Pre-release

See the release evidence ledger and completion matrix for exact passed and open gates.

Docs

Contributions are welcome. Read CONTRIBUTING.md, report security issues through SECURITY.md, and use SuperPlexr under the MIT License.

Releases

Packages

Contributors

Languages