Hammerspoon

Hammerspoon provides macOS automation by exposing system functionality through a Lua scripting engine. It acts as a bridge between the operating system and Lua, offering extensions that let scripts interact with applications, windows, mouse pointers, files, audio devices, batteries, screens, keyboard and mouse events, clipboards, location services, Wi‑Fi and other APIs.

Users create a Lua configuration file (typically ~/.hammerspoon/init.lua) that ties system or—such as network changes, battery level, or keyboard shortcuts—to custom actions, including window management, running AppleScript, or launching applications. Pre‑made plugins called “Spoons” and the full API documentation help users explore and extend the available capabilities.

The project is open‑source and freely available, with a stable release status. Contributions can add new Lua helpers or Objective‑C extensions to expose additional system features, and community support is provided via Discord and a public issue tracker.