hammerspoon-macos-setup

Installation
SKILL.md

Hammerspoon macOS setup

Use the bundled modular configuration as the source of truth. It separates display movement, window layout, Spaces, the window picker, Chrome, and Claude desktop behavior under assets/hammerspoon/modules/.

Install or refresh

Run:

scripts/install-hammerspoon-config.sh

The installer:

  • requires macOS and Homebrew;
  • installs Hammerspoon when absent;
  • backs up existing managed configuration before changing it;
  • symlinks ~/.hammerspoon/init.lua and ~/.hammerspoon/modules to this skill's bundled assets while preserving unrelated entries such as Spoons/;
  • launches Hammerspoon and enables launch at login through the config.
Installs
97
GitHub Stars
1
First Seen
Sep 18, 2026