Hammerspoon

Hammerspoon contributors · Free, MIT-licensed macOS automation through Lua scripts, hotkeys, window control, system events and optional reusable Spoons.

CaskUtilitiesAuto-updatesApple silicon · Intel
From homebrew/cask
30-day installs3,858#54 in App
1-year installs52.1KLast 365 days
Latest version1.1.12 days ago · Oct 7
Download size9.7MBarm64 / x86_64 · zip
Release cadenceIrregular1 release in 30 days
System requirements
>= 13
Platform availability
  • macOS 27 · Intel · 1.1.1 >= 13
  • macOS 27 · Apple chip · 1.1.1 >= 13
  • macOS 26 · Intel · 1.1.1 >= 13
  • macOS 26 · Apple chip · 1.1.1 >= 13
  • macOS 15 · Intel · 1.1.1 >= 13
  • macOS 15 · Apple chip · 1.1.1 >= 13
  • macOS 14 · Intel · 1.1.1 >= 13
  • macOS 14 · Apple chip · 1.1.1 >= 13
  • macOS 13 · Intel · 1.1.1 >= 13
  • macOS 13 · Apple chip · 1.1.1 >= 13
View full declaration
{
  "macos": {
    ">=": [
      "13"
    ]
  }
}
Tap
homebrew/cask
Also known as
Hammerspoon · hammerspoon
Commands
hs
SHA-256
11bb1c90faf5427f…

Installation and removal contents

  • Uninstall uninstall

    View full declaration
    {
      "uninstall": [
        {
          "quit": "org.hammerspoon.Hammerspoon"
        }
      ]
    }
  • Install app

    Source file: Hammerspoon.app

    Declared destination: /Applications/Hammerspoon.app

    View full declaration
    {
      "app": [
        "Hammerspoon.app"
      ],
      "target": "/Applications/Hammerspoon.app"
    }
  • Install binary

    Source file: $APPDIR/Hammerspoon.app/Contents/Frameworks/hs/hs

    Declared destination: $HOMEBREW_PREFIX/bin/hs

    View full declaration
    {
      "binary": [
        "$APPDIR/Hammerspoon.app/Contents/Frameworks/hs/hs"
      ],
      "target": "$HOMEBREW_PREFIX/bin/hs"
    }
  • Remove user data zap

    View full declaration
    {
      "zap": [
        {
          "trash": [
            "~/.hammerspoon",
            "~/Library/Application Support/com.crashlytics/org.hammerspoon.Hammerspoon",
            "~/Library/Caches/org.hammerspoon.Hammerspoon",
            "~/Library/Preferences/org.hammerspoon.Hammerspoon.plist",
            "~/Library/Saved Application State/org.hammerspoon.Hammerspoon.savedState"
          ]
        }
      ]
    }

An open-source interface for Homebrew. Installs run through the macOS app or the brew command.

© 2026 OpenNavo