A modernized rewrite of Hammerspoon - a powerful macOS application for automating your Mac using JavaScript.

Hammerspoon 2 is currently considered EXPERIMENTAL. There may be crashes, memory leaks, bugs, etc. and the JavaScript API may change radically without warning.

Hammerspoon 2 is targeting to release with macOS 27 as the minium supported version.

Pre-releases up to (and including) 0.0.6 target macOS 15.6 and support both Apple Silicon and Intel

From a future pre-release onwards, builds will require at least macOS 26, and once macOS 27 releases, that will become the minimum target.

• Download one of the pre-releases from GitHub, unzip and place in /Applications
• Create ~/.config/hammerspoon2/init.js
• For the JavaScript API docs, see https://cmsj.github.io/Hammerspoon2/

This is an Xcode project. Open Hammerspoon 2.xcodeproj in Xcode to build.

See the LICENSE file for details.

This is a modernized rewrite of the original Hammerspoon project.