skills.rest
whilp
whilpCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

hammerspoon

Configure Hammerspoon automation workflows for macOS app launching and window switching.

9|3|Updated Jun 29, 2012
Search Tags:#automation#macos#leader#hs#window-switcher#hammerspoon
One-click install
npx skills add https://github.com/whilp/dotfiles --skill hammerspoon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hammerspoon
Source: https://github.com/whilp/dotfiles/tree/main/.claude/skills/hammerspoon
Command: npx skills add https://github.com/whilp/dotfiles --skill hammerspoon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill configures and extends Hammerspoon automation for app launching, window switching, and leader modal interactions on macOS.

Core Features & Use Cases

  • Hyper key & bindings: inline hyper key implementation and binding system.
  • Leader modal & pickers: nested leader keys with emoji and symbol pickers.
  • Window switcher: unified launcher/dispatcher modal for windows, apps, and commands.

Quick Start

Install Hammerspoon, place init.lua in ~/.config/hammerspoon, and reload the config.

Frequently Asked Questions about hammerspoon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up macOS automation with Hammerspoon?▼

macOS automation with Hammerspoon begins by installing Hammerspoon, then placing an init.lua configuration file in ~/.config/hammerspoon and reloading the config. The init.lua file must include hs.ipc.cliInstall() to enable CLI integration and define your automation workflows using Hammerspoon's API.

Can I create custom keybindings and a leader modal in Hammerspoon?▼

Yes, Hammerspoon supports custom keybindings through a Leader DSL for binding definitions and nested leader key workflows. You can build modal interactions with emoji and symbol pickers, enabling multi-step keyboard-driven automation for app launching and window management.

How do I implement a window switcher in Hammerspoon?▼

A window switcher in Hammerspoon uses hs.chooser to create a unified launcher/dispatcher modal for windows, apps, and commands. This provides keyboard-accessible switching and command execution without leaving your keyboard, integrated with window management workflows.

Does Hammerspoon work with other macOS window management tools?▼

Hammerspoon integrates with AeroSpace and other window management tools for advanced automation. The Skill supports coordination between Hammerspoon's keybinding and modal system and external window managers to extend macOS automation capabilities.

What's required to troubleshoot Hammerspoon automation issues?▼

Troubleshooting Hammerspoon requires understanding init.lua configuration syntax, verifying hs.ipc.cliInstall() is present, checking keybinding and leader modal definitions, and testing window switcher integration. The Skill covers editing ~/.config/hammerspoon and resolving app launching and window switching failures.

Can I use Hammerspoon with a hyper key for custom automation?▼

Yes, Hammerspoon supports inline hyper key implementation for binding custom automation sequences. The hyper key combined with the Leader DSL enables complex, nested keyboard workflows for launching apps and executing commands on macOS.

Related Skills

Explore More Software Engineering Skills→
greenheadHQgreenheadHQ
4

automating-hammerspoon

Diagnose Hammerspoon hotkey issues and manage launchd agents across macOS.

Community
Advanced
bharthraj1412bharthraj1412

Heartbeat

Automate periodic system health checks across services and hosts.

Community
Advanced
whilpwhilp
9

hammerspoon

Configure Hammerspoon automation workflows for macOS app launching and window switching.

Community
Advanced
vasilyu1983vasilyu1983
73

qa-testing-ios

Automate iOS app builds, tests, and UI automation with Xcode simulators.

Community
Advanced