Install the hs command-line tool to the given directory as a symlink.
Creates a symlink in the target directory that points to the hs binary inside the
Hammerspoon 2 app bundle. Using a symlink means the CLI automatically reflects any
app update without reinstalling. Any existing hs file at that path is replaced.
The directory must be on your $PATH for hs to work without a full path.
Permissions:* /usr/local/bin is typically user-writable on Intel Macs with Homebrew.
On Apple Silicon, prefer /opt/homebrew/bin. On a stock Mac (no Homebrew), both
directories require root — if this method returns false, run the logged command in
a terminal with sudo.
Parameters
directory: string
Directory to install into. Defaults to /usr/local/bin.
Returns boolean
true on success, false on error (details logged to the console).
Install the
hscommand-line tool to the given directory as a symlink. Creates a symlink in the target directory that points to thehsbinary inside the Hammerspoon 2 app bundle. Using a symlink means the CLI automatically reflects any app update without reinstalling. Any existinghsfile at that path is replaced. The directory must be on your$PATHforhsto work without a full path. Permissions:*/usr/local/binis typically user-writable on Intel Macs with Homebrew. On Apple Silicon, prefer/opt/homebrew/bin. On a stock Mac (no Homebrew), both directories require root — if this method returnsfalse, run the logged command in a terminal withsudo.