Hammerspoon 2

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

WARNING

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

Minimum requirements

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.

Using Hammerspoon

• 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/ or run hs.docs.show() in the Console window

Development

Building

This is an Xcode project. Open Hammerspoon 2.xcodeproj in Xcode to build. To generate doc artifacts, run npm install in the top level of the repository.

License

See the LICENSE file for details.

Acknowledgments

This is a modernized rewrite of the original Hammerspoon project.