wmux  by openwong2kim

Windows terminal multiplexer for AI agent fleets

Created 4 months ago
260 stars

Top 97.5% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides a native Windows terminal multiplexer designed for AI agent development, offering parallel execution, robust session persistence, and integrated browser automation. It targets AI engineers and researchers needing to manage complex agent fleets, enabling them to fan out prompts, review code changes, and recover from system reboots seamlessly, thereby enhancing productivity on Windows without relying on WSL.

How It Works

wmux is an Electron-based application that functions as a terminal multiplexer using Windows ConPTY and xterm.js. It orchestrates multiple AI agents (e.g., Claude Code, Codex, Gemini) across isolated git worktrees. Agents communicate via a Meta-Command Protocol (MCP) server, allowing them to delegate tasks and control a real browser through the Chrome DevTools Protocol (CDP). A core feature is its daemon-managed session persistence, ensuring agent processes and conversation states are automatically resumed after application crashes or OS reboots.

Quick Start & Requirements

  • Primary Install: Use winget install openwong2kim.wmux, choco install wmux, or download Setup.exe. A PowerShell one-liner is also available: irm https://raw.githubusercontent.com/openwong2kim/wmux/main/install.ps1 | iex.
  • Prerequisites: Windows 10/11. Building from source requires Node.js (18+), Python (3.x), and VS Build Tools (C++ workload).
  • Links: Releases: https://github.com/openwong2kim/wmux/releases/latest

Highlighted Details

  • Agent Fleet Persistence: Distributes prompts across up to 8 isolated agents in separate git worktrees, with full session and conversation state recovery after crashes or OS reboots.
  • Integrated Git & Browser Automation: Features a Git tab for worktree management, PRs, and diff viewing, alongside built-in Chrome automation via CDP for agent web interactions.
  • Multi-Agent Coordination: Supports agent-to-agent messaging, task delegation, and explicit approval gates for code execution, facilitating controlled multi-agent workflows.
  • MCP Server Integration: Automatically detects and integrates with AI coding agents, enabling programmatic use of terminal and browser tools.

Maintenance & Community

The project is actively developed with a focus on stability and feature expansion. Contributions are welcomed, with guidelines provided in CONTRIBUTING.md. No specific community channels or external partnerships are detailed in the README.

Licensing & Compatibility

  • License: MIT License.
  • Compatibility: Permissive for commercial use and integration with closed-source projects. Designed exclusively for native Windows environments.

Limitations & Caveats

This tool is strictly Windows-only and does not support WSL. Users may encounter Windows SmartScreen warnings on the installer due to a lack of Authenticode signing, requiring manual overrides or installation via package managers. It is a native implementation inspired by tmux rather than a direct port.

Health Check
Last Commit

19 hours ago

Responsiveness

Inactive

Pull Requests (30d)
207
Issues (30d)
19
Star History
54 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.