> ## Documentation Index
> Fetch the complete documentation index at: https://flightdeck.saad.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# FlightDeck

> Signed and notarized i3-like tiling window manager for macOS.

FlightDeck is an i3-like tiling window manager for macOS.
It is a signed and notarized distribution of [AeroSpace](https://github.com/nikitabobko/AeroSpace), preserving full configuration and CLI compatibility.

## Documentation

### [Installation & Guide](/guide)

Start here: Homebrew installation, config file location, layouts, workspaces, binding modes, and focus callbacks.

### [Config Reference](/config-reference)

Complete reference for every supported TOML option — types, defaults, version restrictions, deprecations, and examples.

### [Commands](/commands)

All `flightdeck` CLI subcommands with synopsis and options. Also available as manpages.

### [AeroSpace Compatibility](/compatibility)

Preserved paths and interfaces, current distribution differences, and migration guidance from AeroSpace.

### [Goodies](/goodies)

Community tips: window dragging, non-native fullscreen, JankyBorders integration, and more.

## Quick Start

```bash theme={null}
brew install --cask saadjs/tap/flightdeck
```

Existing AeroSpace configs and `~/.aerospace.toml` work without changes.
Use `flightdeck` instead of `aerospace` for terminal invocations.

The canonical `saadjs/tap/flightdeck` cask follows the latest published AeroSpace release, including upstream beta releases — see [Installation & Guide](/guide#homebrew-installation-preferred).

## About

FlightDeck is built from the AeroSpace source and adds:

* Developer ID codesigning and Apple notarization
* Stapled Gatekeeper tickets so the first launch never blocks
* Homebrew cask distribution at `saadjs/tap/flightdeck`

Configuration syntax, paths (`~/.aerospace.toml`), and environment variables (`AEROSPACE_*`) are intentionally unchanged so existing configurations continue to work.
FlightDeck and AeroSpace should not run simultaneously.

Bugs in the underlying window manager can be reported upstream at [https://github.com/nikitabobko/AeroSpace/issues](https://github.com/nikitabobko/AeroSpace/issues).
FlightDeck-specific issues (distribution, signing, CLI) go to [https://github.com/saadjs/FlightDeck/issues](https://github.com/saadjs/FlightDeck/issues).