Hammerspoon/hammerspoon
Staggeringly powerful macOS desktop automation with Lua observed · 2026-08-28
Health v2 · maintenance only
82/100
- Activity 91
- Release rhythm 60
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.
- gap_med: 63
- age_days: 4347
- days_rel: 188
- days_push: 56
- n_releases_24m: 2
Adoption not part of the score
15999 stars · 712 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded
Hammerspoon is a macOS desktop automation application that bridges the operating system's APIs to a Lua scripting engine. Users write Lua configuration scripts to control windows, applications, keyboard/mouse events, and many other system functions.
Use cases
- automate window management on macOS
- bind custom keyboard shortcuts to system actions
- run scripts when wifi connects to a network
- show alerts when battery drops below a threshold
- control mouse and keyboard events programmatically
- watch for application launch and quit events
- script macOS accessibility APIs
When to choose
- you want deep, scriptable automation of macOS with Lua
- you need fine-grained control over windows, hotkeys, and system events
- you prefer a free, open-source alternative to paid Mac automation tools
- you want to extend functionality with community Spoons or your own modules
When to avoid
- you need a no-code automation tool with a GUI
- you want cross-platform automation beyond macOS
- you are not comfortable writing and maintaining Lua scripts
- you only need simple app launching that Spotlight already covers
Facets
application · maturity active
developer-tools workflow-automation plugin-system gui developer-tools desktop-applications lua lua-scripting desktop-automation window-management keyboard-shortcuts hotkeys accessibility-api spoons automation macos desktop
5 sources
- readme: https://github.com/Hammerspoon/hammerspoon · fetched 2026-08-28 · 0141bb95d176
- homepage: http://www.hammerspoon.org · fetched 2026-08-29 · 3e96f7b0bdc9
- site_page: http://www.hammerspoon.org/docs/index.html · fetched 2026-08-29 · d9c64a687dc9
- site_page: http://www.hammerspoon.org/docs · fetched 2026-08-29 · 2d782bfa5bc7
- site_page: http://www.hammerspoon.org/faq · fetched 2026-08-29 · 273743d6bfe0
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| Hammerspoon/hammerspoon | main | 82 |
For agents
markdown · JSON · MCP: product_card(name="Hammerspoon/hammerspoon")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem