macOS
Homebrew Caskverified · 100%
brew install --cask hammerspoonlocal Homebrew cask metadata
cask
Install hammerspoon with Homebrew Cask
Desktop automation application. Version 1.1.1 via Homebrew Cask; verified from local package data.
install
Additional install commands
overview
Package summary
Desktop automation application
Project links
Commands and aliases
- hs
history
Project history and usage
Hammerspoon is an open-source macOS desktop-automation environment that bridges the operating system to an embedded Lua scripting engine. Users assemble automation from a growing collection of extensions and reusable Spoons.
Project history
Hammerspoon is a fork of Mjolnir. Whereas Mjolnir favored a minimal core with externally managed extensions, Hammerspoon's maintainers pursued a more integrated application bundling the Lua engine and system-facing extensions.
The project belongs to a lineage of programmer-centric macOS automation tools associated with Hydra, Phoenix, Zephyros, and Mjolnir. Hammerspoon retained the scriptable approach while expanding coverage of macOS APIs and smoothing extension interoperability.
Adoption history
Hammerspoon developed a substantial ecosystem of user configurations and reusable plugins called Spoons. Its official organization maintains a dedicated Spoons repository, while Homebrew Cask provides a common installation route for macOS automation enthusiasts.
How it is used
Hammerspoon initially does nothing until the user creates ~/.hammerspoon/init.lua. Typical configurations define keyboard shortcuts, window layouts, application controls, menu-bar items, event watchers, and automation hooks. Reusable Spoons can be installed under ~/.hammerspoon/Spoons/ and loaded from the Lua configuration.
Why package nerds care
Hammerspoon appeals to package and dotfile enthusiasts because its behavior is text-configured in Lua and can be version-controlled. It occupies a distinctive space between a hotkey utility, a window manager, and a general macOS automation runtime.
Timeline
- Mjolnir era: Established a lightweight, programmer-oriented Lua automation model for OS X.
- Hammerspoon fork: Created from Mjolnir to provide a more integrated extension experience.
- Later development: Expanded macOS API coverage and established the official Spoons plugin ecosystem.
Related projects
- Mjolnir is Hammerspoon's direct upstream ancestor. Hydra, Phoenix, and Zephyros are related predecessors in the same macOS automation lineage. The official Spoons repository distributes reusable Hammerspoon plugins.
Sources
- Official API documentation: https://www.hammerspoon.org/docs/
- Official Getting Started guide: https://www.hammerspoon.org/go/
- Official Mjolnir repository: https://github.com/mjolnirapp/mjolnir
- Official Spoons catalog: https://www.hammerspoon.org/Spoons/
- Official repository: https://github.com/Hammerspoon/hammerspoon
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for hammerspoon. Package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- macOS
~/.hammerspoon/init.lua
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
hs | binary | Homebrew cask binary | hs |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-11-04
manager version1.1.1
manager updated
local dataok
upstreamnot checked
latest detectednot detected
https://github.com/Hammerspoon/hammerspoon
- infoNo package-manager update timestamp was available.low confidence
- infoNo cached GitHub release or tag data was available.https://github.com/Hammerspoon/hammerspoonnone confidence
install metadata
Package metadata
| Package key | cask:hammerspoon |
|---|---|
| Version | 1.1.1 |
| Package manager | Homebrew Cask |
| Package manager page | https://formulae.brew.sh/cask/hammerspoon |
| Homepage | https://www.hammerspoon.org/ |
| Repository | https://github.com/Hammerspoon/hammerspoon |
| Upstream docs | https://www.hammerspoon.org/ |
| Source archive | https://github.com/Hammerspoon/hammerspoon/releases/download/1.1.1/Hammerspoon-1.1.1.zip |
| SHA-256 | 11bb1c90faf5427f37c7bd4fe7eab9774ae43e1d5cb020c5b3088dac32849efa |
| Bottle | not recorded |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew cask API |
|---|---|
| Tap | homebrew/cask |
| Full Token | hammerspoon |
| Names |
|
| Depends On | |
| Artifacts | |
| Auto Updates | yes |
| Deprecated | no |
| Disabled | no |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- package relationship graph
- package version freshness
- package-page enrichment