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

aegis_1_spaceindicators.mp4

App launcher - Quick-access floating apps button with configurable app list (e.g. finder, iTerm, passwords etc)

aegis_2_applauncher_1.mp4

aegis_2_applauncher_2_scrollmenu.mp4

Context button - a scroll-able button to cycle through yabai commands. Right click menu for expanded commands (stack windows, move to/destroy space, access settings etc)

aegis_3_context_menu.mp4

• System status - Battery, WiFi, Focus mode, clock
• Multi-display support - Menu bars on all connected monitors with configurable modes (auto, primary only, per-monitor, all show all)

Notch HUD

Volume	Brightness
aegis_4_notch_volume.mp4	aegis_4_notch_brightness.mp4
Focus Mode	Device Connect
aegis_4_notch_focus.mp4	aegis_4_notch_deviceconnect.mp4
Media
aegis_4_notch_music.mp4

• Media - Album art with visualizer or track info (static or marquee scrolling for long titles)
  • Works with Music, Spotify, Safari, Chrome, Firefox, YouTube, and more
• 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.