Skip to content

saadjs/FlightDeck

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,636 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FlightDeck

FlightDeck is an i3-like tiling window manager for macOS.

Note

FlightDeck is a fork of AeroSpace by Nikita Bobko. This project is not affiliated with or endorsed by the original AeroSpace project.

Documentation

Install the signed and notarized release from the Homebrew tap:

brew install --cask saadjs/tap/flightdeck

See the FlightDeck documentation, command reference, and bundled flightdeck manpages for usage and configuration details.

AeroSpace compatibility

FlightDeck preserves AeroSpace's configuration format and compatibility-sensitive interfaces. Existing configs continue to load from ~/.aerospace.toml or ${XDG_CONFIG_HOME}/aerospace/aerospace.toml, and existing AEROSPACE_* callback variables and aerospace_workspace_change integrations remain unchanged.

Use flightdeck instead of aerospace for CLI invocations. Commands inside the TOML config do not need to be changed. FlightDeck does not install an aerospace CLI alias, and FlightDeck and AeroSpace should not run simultaneously.

Key features

  • Tiling window manager based on a tree paradigm
  • i3-inspired
  • Fast workspace switching without animations and without the necessity to disable SIP
  • Plain text configuration for dotfiles-friendly setup
  • CLI first, with manpages and shell completion included
  • Proper multi-monitor support

Development

Project setup, build instructions, and test details are available in dev-docs/development.md.

Distribution

FlightDeck is Developer ID-signed, notarized by Apple, and distributed through saadjs/homebrew-tap.

Project values

Values

  • Targeted at advanced users and developers
  • Keyboard centric
  • Breaking changes to configuration files, CLI behavior, and runtime behavior are avoided when possible
  • No GUI for configuration
  • Practical features over cosmetic features
  • Avoid private APIs, code injection, and other brittle integrations as much as possible

Non Values

  • Playing nicely with every existing macOS window-management feature
  • Visual customization beyond practical integrations

macOS compatibility table

macOS 13 (Ventura) macOS 14 (Sonoma) macOS 15 (Sequoia) macOS 26 (Tahoe)
FlightDeck binary runs on ... + + + +
FlightDeck debug build from sources is supported on ... + + +
FlightDeck release build from sources is supported on ... (Requires Xcode 26+) + +

Related projects

About

An i3-like tiling window manager for macOS

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors