Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 

README.md

Hammerspoon Plugin

Automate macOS with Hammerspoon Lua scripting. Window management, hotkeys, Spoons, and CLI integration.

Features

  • Window Management - Configure tiling hotkeys with ShiftIt Spoon
  • Hotkey Binding - Create custom keyboard shortcuts
  • Spoons - Load and configure Hammerspoon plugins
  • CLI Integration - Use hs command for scripting and reloading
  • Configuration - Manage ~/.hammerspoon/init.lua

Installation

claude plugin install hammerspoon@plinde-plugins

Usage

The skill activates automatically when:

  • Working with ~/.hammerspoon/ configuration
  • Writing Lua code for macOS automation
  • Configuring window management hotkeys
  • Using the hs CLI command

Quick Reference

Enable CLI Support

Add to ~/.hammerspoon/init.lua:

require("hs.ipc")

Then reload manually via menubar.

Reload from CLI

hs -c 'hs.reload()'

ShiftIt Window Hotkeys

hs.loadSpoon("ShiftIt")
spoon.ShiftIt:bindHotkeys({
    left = { { 'ctrl', 'cmd' }, 'left' },
    right = { { 'ctrl', 'cmd' }, 'right' },
    maximum = { { 'ctrl', 'cmd' }, 'm' },
})

Requirements

License

MIT License

Author

Peter Linde