// troubleshooting guide · hammerspoon

Hammerspoon Accessibility Permission Not Working

Status
Workaround available
platforms:
macOS
updated:
November 16, 2026
reports:
2
Method
how we research
Share

RUNBOOK · hammerspoon/accessibility-permission3 FIXES

// quick answer

Hammerspoon needs Accessibility enabled to control windows and keys. Toggle it in Privacy & Security, and reset with tccutil if it will not stick.

Most likely fix: Enable Accessibility

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Enable Accessibility

    1. 01Open System Settings > Privacy & Security > Accessibility
    2. 02Make sure Hammerspoon is in the list and ticked
    3. 03Quit and relaunch Hammerspoon
    Did this fix it?
  2. FIX 2Reset permissions with tccutil

    1. 01Quit Hammerspoon
    2. 02In Terminal run: tccutil reset All org.hammerspoon.Hammerspoon
    3. 03Relaunch and grant Accessibility again
    Did this fix it?
  3. FIX 3Rebuild the Launch Services database

    1. 01As a last resort, run the lsregister -kill -r command from the Hammerspoon FAQ with sudo
    2. 02Restart the Mac and grant permission again
    Did this fix it?

Symptoms

Hammerspoon starts but hotkeys or window actions do nothing, or the Accessibility checkbox cannot be enabled.

Why it happens

  • C-01Permission not granted
  • C-02Permissions database out of sync
  • C-03Duplicate app entries

// this guide also covers

  • hammerspoon accessibility
  • hammerspoon permission not working

Still not working?

If Hammerspoon keeps failing, you're not alone. See every Hammerspoon problem users report or the alternatives people switch to.

Done fighting Hammerspoon? Our small team builds your own Hammerspoon alternative, or any software you need: web, mobile, games, desktop. Price agreed together.

Talk to us

Watch Hammerspoon Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other Hammerspoon errors