// troubleshooting guide · hammerspoon
Hammerspoon Accessibility Permission Not Working
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 2
- Method
- how we research
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
FIX 1Enable Accessibility
- 01Open System Settings > Privacy & Security > Accessibility
- 02Make sure Hammerspoon is in the list and ticked
- 03Quit and relaunch Hammerspoon
Did this fix it?FIX 2Reset permissions with tccutil
- 01Quit Hammerspoon
- 02In Terminal run: tccutil reset All org.hammerspoon.Hammerspoon
- 03Relaunch and grant Accessibility again
Did this fix it?FIX 3Rebuild the Launch Services database
- 01As a last resort, run the lsregister -kill -r command from the Hammerspoon FAQ with sudo
- 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 usOther Hammerspoon errors
- Hammerspoon Keystrokes Not Working
- Hammerspoon Hotkeys Stop Working
- Hammerspoon Timer or Watcher Stops Working
- Hammerspoon Modal Hotkeys Not Working
- Hammerspoon UI Not Showing in Full-Screen Apps
- Hammerspoon Cannot Find Application By Name
- Hammerspoon selectMenuItem Not Working From Console
- Hammerspoon v2: What Changes and Should You Wait