amirlehmam/wmux

The original Windows terminal multiplexer for AI agents.

What it solves

wmux is a visibility layer for AI coding agents on Windows, designed to prevent users from having to manually hunt through multiple terminal tabs to find which agent is waiting for input or has finished a task. It provides a centralized way to monitor and interact with multiple parallel agent sessions (such as Claude Code, Aider, or Copilot) without replacing the agents themselves.

How it works

Built on Electron and xterm.js, wmux acts as a terminal multiplexer that passively observes agent activity. It uses a combination of methods to track state:

  • Reported State: Integration via hooks (e.g., in ~/.claude/settings.json) allows agents like Claude Code to report activity directly.
  • Screen Detection: For agents that don't report state, wmux uses local rules to match the agent's on-screen UI against bundled patterns to determine if they are "blocked" or "working."
  • CDP Proxy: A Chrome DevTools Protocol proxy on localhost:9222 allows agent browser tools to control a built-in browser panel, making the agent's web activity visible in real-time.

Who it’s for

Developers on Windows who run multiple AI coding agents in parallel and need a high-level overview of their progress, notifications when agents need attention, and a way to quickly jump between active sessions.

Highlights

  • Agent Roster & Navigator: A banner and dedicated navigator (Ctrl+Shift+A) that ranks agents by who has been waiting longest.
  • Live Browser Visibility: A built-in browser panel that shows real-time web browsing actions performed by agents.
  • Activity Indicators: Color-coded dots (violet for needs attention, orange for working, green for done) that indicate session state.
  • Integrated File Explorer: A docked file tree (Ctrl+Shift+X) that shows the current working directory of the focused pane, including change counts for files and folders.
  • Code Editing: A basic code surface that allows users to edit files and save changes directly within the multiplexer.
  • Notification Center: Visual alerts (blue rings, taskbar flashes) and a centralized list of pending notifications.
  • Scriptable API: A JSON-RPC API via a named pipe server for programmatic control of workspaces and panes.

Related

  • Project
    craftzdog/tmux-claude-session-manager

    A tmux plugin that lets you manage multiple Claude Code sessions, providing a central picker to monitor agent status and jump between them.

  • Project
    hiroppy/tmux-agent-sidebar

    A tmux plugin that provides a centralized sidebar to monitor and manage AI coding agents like Claude Code, Codex, and OpenCode across all sessions and windows.

  • Project
    simple10/agents-observe

    A real-time observability dashboard for Claude Code and Codex agents that provides visibility into subagent hierarchies, tool calls, and token usage.

  • Project
    openwong2kim/wmux

    A workspace multiplexer for AI agents that allows running multiple agents in parallel across isolated git worktrees with persistent sessions and agent-to-agent coordination.

  • Project
    gbasin/agentboard

    A web GUI for tmux optimized for AI agent TUIs, enabling remote and mobile access to agent sessions with status tracking and specialized mobile controls.