automating-hammerspoon

Diagnose Hammerspoon hotkey issues and manage launchd agents across macOS.

4|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/greenheadHQ/nixos-config --skill automating-hammerspoon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: automating-hammerspoon
Source: https://github.com/greenheadHQ/nixos-config/tree/main/.claude/skills/automating-hammerspoon
Command: npx skills add https://github.com/greenheadHQ/nixos-config --skill automating-hammerspoon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Streamlines macOS automation by coordinating Hammerspoon hotkeys, launchd agents, and Ghostty integration to diagnose and fix desktop automation issues.

Core Features & Use Cases

  • Centralized management of Hammerspoon hotkeys and their reloads
  • LaunchAgent lifecycle monitoring and automatic recovery
  • Ghostty integration to reliably open terminals and navigate working directories
  • Troubleshooting guidance for common macOS automation problems

Quick Start

Follow the steps to diagnose Hammerspoon init.lua, check active LaunchAgents, and verify Ghostty behavior before reloading configurations.

Frequently Asked Questions about automating-hammerspoon

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

FAQPage Schema
How do I automate macOS desktop workflows using Hammerspoon and launchd?

Automate macOS desktop workflows by coordinating Hammerspoon lua configurations, launchd agents, and AppleScript APIs. This approach detects LaunchAgent states, reloads configurations automatically, and simulates keystrokes across apps to resolve desktop automation issues.

How do I troubleshoot Hammerspoon hotkeys not working on macOS?

Troubleshoot Hammerspoon hotkeys by diagnosing the init.lua configuration and checking active LaunchAgents. You can verify Ghostty terminal behavior, detect agent states, and reload configurations to resolve hotkey conflicts and restore desktop automation functionality.

Can I use Hammerspoon to manage launchd agents and automatically recover them?

Yes, you can manage launchd agents using Hammerspoon lua configuration to monitor LaunchAgent lifecycles. The system detects agent states and triggers automatic recovery by reloading configurations when macOS automation agents fail.

Does Hammerspoon work with Ghostty terminals to open working directories?

Hammerspoon integrates with Ghostty to reliably open terminals and navigate working directories. Using AppleScript and hs APIs, the integration ensures Ghostty terminals launch predictably across macOS environments during automated workflows.

Why do my Hammerspoon keystroke simulations fail across different macOS apps?

Keystroke simulations fail due to misconfigured Hammerspoon init.lua files or inactive LaunchAgents. Diagnose the EventTap configurations, verify active agent states, and reload the lua setup to ensure simulated keystrokes register correctly across apps.

What is the best way to reload Hammerspoon configurations after updating launchd agents?

The best way to reload Hammerspoon configurations is to diagnose the init.lua file, check active LaunchAgents, and verify Ghostty behavior. This ensures launchd agent updates apply correctly and Hammerspoon hotkeys resume functioning.