AeroKit

A visual companion layer for AeroSpace.

AeroKit adds a Cmd-Tab-style workspace switcher, spatial Exposé and App Exposé, and three-finger workspace navigation without changing the AeroSpace layout.

▶ Watch the 29-second demo

• Workspace Switcher with snapshot previews
• Exposé and App Exposé with spatial window layout
• Three-finger workspace switching

Switch AeroSpace workspaces like apps in Cmd-Tab, with snapshots and app icons that make the destination recognizable before switching.

See the focused workspace as a spatial overview, or find every window of the focused app across workspaces, then jump directly to the one you need.

Move between workspaces with a natural three-finger swipe and a compact HUD that follows the gesture.

• macOS 14 (Sonoma) or later
• AeroSpace installed and running (brew install --cask nikitabobko/tap/aerospace)
• Screen Recording permission for window previews (the app works without it, minus previews)

With Homebrew (signed & notarized universal build):

brew install --cask jomatsu/tap/aerokit

Or build and install from source:

git clone https://github.com/jomatsu/aerokit.git
cd aerokit/packages/app
scripts/install-app.sh

The from-source install builds a release binary and wraps it into ~/Applications/AeroKit.app. Either way, on first launch the app registers itself as a login item (System Settings › General › Login Items), toggleable from the settings window.

See packages/app for features, default hotkeys, and CLI flags.

make bootstrap  # install SwiftFormat, SwiftLint and AeroSpace through Homebrew
make format     # format all packages
make lint       # lint all packages
make build      # build all packages
make test       # test all packages
make check      # lint + build + test

Formatting and linting rules are shared across packages via the root .swiftformat and .swiftlint.yml.

Release maintainers should follow docs/releasing.md for Developer ID signing, notarization, GitHub Releases, and Homebrew tap updates.

MIT