Aegis

A macOS menu bar replacement for Yabai window manager. Transforms your menu bar and notch into a control center for spaces, windows, and system status.

Features

• Workspace indicators - Visual space display with window icons, click to focus, drag to move
• Layout controls - Rotate, flip, balance, stack windows via scroll wheel or menu
• Notch HUD - Volume, brightness, now-playing media, Bluetooth devices, Focus mode, and system notifications with smooth animations
• System status - Battery, WiFi, Focus mode, clock in the menu bar
• Customizable - Simple settings panel with advanced options
• Auto-updates - Built-in update checking via Sparkle

Quick Start

1. Install Yabai

brew install koekeishiya/formulae/yabai

See the Yabai wiki for setup (SIP configuration, scripting addition).

2. Install Aegis

Download from Releases or build from source:

git clone https://github.com/CCMurphy-Dev/Aegis.git
cd Aegis
open Aegis.xcodeproj

3. Run Setup (Optional)

On first launch, Aegis will prompt you to run the setup if needed. Alternatively, run manually:

~/.config/aegis/setup-aegis-yabai.sh

This configures the FIFO pipe integration for instant space/window updates.

4. Grant Permissions

• Accessibility - System Settings → Privacy & Security → Accessibility

Requirements

• macOS 14.0+ (Sonoma)
• Apple Silicon Mac with notch (recommended)
• Yabai window manager

Documentation

• User Guide - Full documentation, configuration, and troubleshooting
• Changelog - Version history
• Architecture - Technical overview for developers

License

MIT License - see LICENSE for details.

Acknowledgments

• Yabai - Tiling window manager
• skhd - Hotkey daemon
• Sparkle - Auto-update framework
• mediaremote-adapter - Media integration (Now Playing)
• Barik & Mew-Notch - Inspiration

---

Aegis - A shield for your macOS menu bar.