AeroMux

Who It's For

AeroMux is for AeroSpace users who want a persistent, always-visible sidebar showing all their workspaces and windows — similar to a tmux session list, but for your macOS window layout. If you run AeroSpace and find yourself losing track of which workspace holds which windows, AeroMux provides a spatial overview you can glance at without triggering any overlay or leaving your current context. It's free and open-source.

How It Works

AeroMux queries AeroSpace via its IPC socket and renders a persistent left sidebar listing all non-empty workspaces with their window titles underneath each workspace name. Clicking any window in the list immediately focuses that window in AeroSpace. The sidebar stays on screen continuously — it's not a popup you summon and dismiss. Webhook-based refresh lets AeroSpace notify AeroMux of state changes instantly, so the sidebar updates in real time as you move windows between workspaces. Compact mode reduces the sidebar footprint. Width is adjustable to fit your screen setup.

Compared to Similar Tools

Compared to AeroOverlay (floating overlay activated by double-tapping Option), AeroMux is always visible rather than on-demand. AeroOverlay is better for quickly checking workspace state and dismissing the view; AeroMux is better for users who want continuous spatial awareness. Compared to AeroSpaceBar (menu bar workspace indicators), AeroMux shows window titles within each workspace in a vertical list — more information density at the cost of screen real estate.

Requirements

• AeroSpace window manager must be installed and running
• macOS version: check github.com/raghavendra-talur/aeromux for requirements
• Free and open-source

Getting Started

Download from the GitHub releases page and launch alongside AeroSpace. Configure the webhook in your AeroSpace config to trigger AeroMux refreshes on workspace events. Adjust sidebar width and compact mode in AeroMux preferences.