Phoenix

Phoenix is a lightweight macOS utility that lets users manage windows, applications, screens, spaces, mouse and and system events through custom JavaScript (or TypeScript) scripts. By placing a configuration file in a standard location, users can bind keyboard shortcuts and system triggers to callback functions that control the UI, display notifications, show modals, or execute external commands. The tool runs as a status‑bar item or background daemon and requires macOS 10.14 or later, with accessibility permissions granted at first launch.

The software targets power users and developers who want a highly customizable, script‑driven workflow for window and app management without relying on pre‑built shortcuts. Its design emphasizes efficiency and a small footprint, allowing users to tailor behavior to their own preferences rather than using a fixed feature set. Installation is straightforward via a drag‑and‑drop of the app or Homebrew, and the configuration lives in the user’s home directory, making it easy to edit, version‑control, or share.

Phoenix’s distinctiveness lies in exposing the full macOS UI control surface to JavaScript, enabling complex automations such as dynamic window tiling, space switching, and integration with external command‑line tools. The project provides documentation, examples, and a community wiki for sharing configurations, and it maintains a stable master branch with regular releases.