Hammerspoon libraries and ready-to-use Spoons for a sharper macOS workflow.

This repository contains independent Hammerspoon Spoons and reusable Lua libraries. Each Spoon owns its Lua runtime, configuration, data, tests, and detailed documentation; optional Home Manager delivery loads those files and provides Gearbox's required timeout, shared placement, and Scratchpad settings.

Spoons

Spoon	Purpose
Gearbox	Native keyboard launcher with nested menus, an editable scratchpad, arrow navigation, themes, and macOS power controls; inspired by LeaderKey

Libraries

Library	Purpose
RetroUI	Themeable canvas dialogs, text frames, and keyboard- and mouse-driven DOS-style buttons

Example

Copy a Spoon beneath ~/.hammerspoon/Spoons/, then load it from ~/.hammerspoon/init.lua:

require("Spoons.Gearbox").start()

Gearbox intentionally ships with its timeout disabled, so set a positive menu.timeout before loading it. The Gearbox README contains installation, configuration, controls, and architecture details. Nix delivery is available through Home Manager.

License

Copyright © 2025–2026 Martín Cigorraga. Released under the GNU Affero General Public License v3 or later.