Repo brief: nikitabobko/AeroSpace

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T21:19:12.828Z · commit 63e0976bf38f

Verdict

Mixed — Single-maintainer risk — review before adopting

• Last commit 4w ago
• 8 active contributors
• MIT licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

AeroSpace is a tiling window manager for macOS that replicates the i3 Linux window manager paradigm, allowing users to tile windows automatically in a tree-based layout without relying on macOS's native Spaces. It provides keyboard-driven workspace management, multi-monitor support, and plain-text TOML configuration, all implemented as a native Swift application that doesn't require disabling System Integrity Protection. Monolithic Swift application: Sources/AeroSpaceApp/ contains the main entry point (AeroSpaceApp.swift), Sources/AppBundle/ contains the core logic organized by domain (command/, with impl/ subdirectory for command implementations like BalanceSizesCommand.swift,…

Start here

Open these first:

• Sources/AeroSpaceApp/AeroSpaceApp.swift — Application entry point that initializes the window manager and core event loops
• Sources/AppBundle/command/parseCommand.swift — Command parser that converts user input into executable window manager operations, critical for all user interactions
• Sources/AppBundle/config/parseConfig.swift — Configuration file parser that loads user preferences and keybindings, foundational for startup
• Sources/AppBundle/layout/layoutRecursive.swift — Core layout engine implementing the tree-based tiling algorithm, the heart of AeroSpace's window management
• Sources/AppBundle/GlobalObserver.swift — Global event listener that monitors window system events and triggers layout recalculation

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone and build via Xcode:

git clone https://github.com/nikitabobko/AeroSpace.git
cd AeroSpace
xed . # Opens in Xcode
# Or build from command line:
xcodebuild -scheme AeroSpace -configuration Release

For Homebrew installation (pre-built):

brew install --cask nikitabobko/tap/aerospace

Daily commands:

Open in Xcode and build the 'AeroSpace' scheme, or:

xcodebuild -scheme AeroSpace -configuration Release build
./build/Release/AeroSpace # Run the built binary

Once installed, interact via CLI:

aerospace workspace next  # Switch to next workspace
aerospace window focus left  # Focus left window

…shortened for this brief.

Key cautions & unknowns

• Single-maintainer risk — top contributor 90% of recent commits
• No SIP (System Integrity Protection) disabling is required, but the app is not notarized—macOS will quarantine it on first download, requiring either Homebrew's automatic quarantine removal or manual handling via xattr…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.