Getting Started

Requirements

• macOS 13 (Ventura) or later
• Git installed and available in your PATH
• A terminal emulator (Terminal.app, iTerm2, Warp, Ghostty, etc.)

Installation

Download the latest release from GitHub and move the app to your Applications folder.

# Download the latest release
curl -LO https://github.com/PhilipLudington/AirTower/releases/latest/download/AirTower.dmg

# Mount and install
open AirTower.dmg

Alternatively, if you use Homebrew:

brew install --cask airtower

First Launch

When you first open AirTower, it will appear in your menu bar. Click the icon to reveal the floating status panel. AirTower automatically detects the git repository in your current working directory.

• Click the AirTower icon in the menu bar to toggle the panel
• The panel will show git status for the active terminal's working directory
• AirTower polls for changes every 2 seconds by default

Permissions

AirTower needs the following permissions to function:

• Accessibility — to detect the active terminal window and position the panel
• Full Disk Access — optional, only needed if your repos are outside standard directories

You can grant these in System Settings > Privacy & Security.

Next Steps

Once AirTower is running, you can customize it with a .airtower.json config file in your repo root. See the Configuration page for details.