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

Menu Bar

• Space indicators - Visual workspace display with app icons, click to switch, scroll to navigate
• Context button - Shows focused window icon and title, expands on hover
• App launcher - Quick-access floating apps button with configurable app list
• System status - Battery, WiFi, Focus mode, clock

Notch HUD

• Volume/Brightness - Smooth progress bar with adaptive frame rate
• Media - Album art with visualizer or track info (marquee scrolling for long titles)
  • Works with Music, Spotify, Safari, Chrome, Firefox, YouTube, and more
• Bluetooth - Device connection notifications with battery indicator
• Focus Mode - Shows Focus mode icon and name when enabled/disabled
• Notifications - Intercepts system notifications, click to open source app

App Switcher

• Cmd+Tab replacement - Window previews with app icons
• Scroll navigation - Two-finger scroll to cycle through windows
• Cmd+scroll activation - Optional gesture to open switcher (configurable)

Other

• Customizable - JSON config file with hot-reload, plus Settings panel
• Auto-updates - Built-in update checking via Sparkle
• Energy efficient - Animations auto-stop when idle, minimal CPU usage

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
• Roadmap - Completed features and future ideas

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.