Installation

Installation

Requirements

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

Step 1: Install Yabai

brew install koekeishiya/formulae/yabai

See the Yabai wiki for full setup including SIP configuration and scripting addition.

Step 2: Install Aegis

Option A: Download Release

Download the latest .app.zip from Releases, unzip, and move to /Applications.

Option B: Build from Source

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

Build and run with Xcode (Cmd+R).

Step 3: Grant Permissions

When prompted, grant these permissions in System Settings > Privacy & Security:

• Accessibility - Required for window management
• Automation - Required for controlling other apps

Step 4: Yabai Integration (Optional)

On first launch, Aegis will prompt you to run the setup if FIFO integration isn't configured.

Alternatively, run manually:

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

This configures instant space/window updates via a FIFO pipe.

Updating

Aegis includes automatic update checking via Sparkle. Check for updates in Settings > General > Check for Updates.