Hammerspoon: automatización macOS con Lua

¿Qué es Hammerspoon y por qué importa para founders tech?

Hammerspoon es una herramienta gratuita y de código abierto para la automatización avanzada de macOS mediante scripts escritos en Lua. Funciona como un puente directo entre las APIs del sistema operativo y un motor de scripting, exponiendo funcionalidades profundas de macOS sin restricciones de sandboxing. El resultado: un entorno donde puedes programar exactamente cómo quieres que tu Mac se comporte, sin depender de software de pago ni de flujos rígidos.

Para un founder tech que vive entre reuniones, sprints de producto y revisiones de métricas, cada minuto de fricción cuenta. Hammerspoon elimina esa fricción de raíz, permitiendo construir un entorno de trabajo completamente personalizado desde un único archivo de configuración: ~/.hammerspoon/init.lua.

Características clave que lo hacen diferente

A diferencia de herramientas como Rectangle, Moom o Keyboard Maestro (de pago), Hammerspoon ofrece un nivel de control comparable o superior sin costo alguno. Algunos de sus puntos más destacados:

👥 ¿Quieres ir más allá de la noticia?

En nuestra comunidad discutimos las tendencias, compartimos oportunidades y nos ayudamos entre emprendedores. Sin humo, solo acción.

👥 Unirme a la comunidad

Gestión de ventanas precisa: layouts de tiling, redimensionado, cambio de foco y apilado de ventanas con atajos completamente configurables.
Hotkeys contextuales: vincula combinaciones de teclas a lanzamiento de apps, operaciones de portapapeles, intercepción de teclas multimedia o eventos de hardware como el estado de Caps Lock.
Extensibilidad total con Lua: accede a las APIs de Accesibilidad de macOS para automatizar menús, formularios y cualquier elemento de interfaz gráfica.
Bajo consumo de recursos: opera con menos de 12 MB de RAM en reposo, sin polling constante ni fugas de memoria. Benchmarks independientes reportan una latencia de ejecución inferior a 20 ms.
Spoons: el ecosistema de plugins de Lua que amplía las capacidades base con módulos para TOTP, historial de portapapeles, temporizadores de suspensión, cambio de resolución y más.

Instalación y configuración inicial

El proceso de puesta en marcha es directo y toma menos de cinco minutos:

Descarga el instalador DMG desde github.com/Hammerspoon/hammerspoon o instala vía Homebrew: brew install --cask hammerspoon.
Arrastra Hammerspoon.app a la carpeta /Applications y ábrela.
Otorga permisos de Accesibilidad en Configuración del Sistema > Privacidad y Seguridad > Accesibilidad.
Edita el archivo ~/.hammerspoon/init.lua con tus scripts.
Recarga la configuración desde el ícono en la barra de menú o con hs.reload() desde la consola integrada, sin necesidad de reiniciar la app.

Un ejemplo mínimo para verificar que todo funciona:

hs.hotkey.bind({}, 'F1', function() hs.alert.show('Hammerspoon activo') end)

Casos de uso prácticos para founders y equipos tech

Donde Hammerspoon brilla es en la eliminación de tareas repetitivas de alto costo cognitivo. Estos son los casos de uso más valorados por la comunidad tech:

1. Layouts de ventanas con una tecla

Configura una hyper key (por ejemplo, Caps Lock como combinación de Cmd+Alt+Ctrl+Shift) y asigna layouts completos a atajos de una sola tecla. Al llegar a tu Mac de trabajo, un único atajo organiza tu editor, navegador y terminal en segundos:

hyper = {'cmd', 'alt', 'ctrl', 'shift'}
hs.hotkey.bind(hyper, 'L', function()
  -- lógica de layout aquí
end)

2. Automatización de pruebas de user agent en Safari

Desarrolladores y founders que validan experiencias mobile pueden ciclar entre user agents (Default, Edge, Chrome) con un solo atajo, sin entrar a los menús de desarrollador manualmente en cada prueba.

3. Portapapeles inteligente e inyección de JS

Copia atributos de elementos del DOM directamente al portapapeles y dispara un atajo que inyecta una consulta JavaScript en el inspector de Safari. Ideal para founders que revisan funnels de conversión y necesitan inspeccionar comportamientos de UI rápidamente.

4. Utilitarios en la barra de menú

Construye pequeñas apps de menú para tareas recurrentes: autotipeo de códigos TOTP al hacer clic, guardado simultáneo de capturas de pantalla al disco y al portapapeles, o temporizadores de suspensión para preservar la batería durante presentaciones.

5. Reducción de cambio de contexto en sesiones de código

Según datos de uso comparativos, flujos basados en Hammerspoon pueden reducir el tiempo en tareas repetitivas hasta en un 53% y los errores de operación en un 68% frente a métodos manuales, al eliminar el uso del ratón en operaciones frecuentes.

El ecosistema de Spoons: extensiones de la comunidad

Los Spoons son módulos de Lua desarrollados por la comunidad que se instalan en la carpeta ~/.hammerspoon/Spoons/. Extienden las capacidades base con funciones preempaquetadas listas para usar. Entre los más populares:

SpoonInstall: gestor oficial para instalar y actualizar otros Spoons desde la consola.
RecursiveBinder: crea menús de atajos encadenados (chording) para reducir colisiones de hotkeys.
ClipboardTool: historial persistente del portapapeles con búsqueda.
Caffeine: impide que la pantalla entre en suspensión durante demos o presentaciones.

La documentación oficial en hammerspoon.org cubre todos los módulos del core (hs.window, hs.hotkey, hs.application, hs.timer, hs.caffeinate, entre otros) con ejemplos reproducibles.

Compatibilidad y rendimiento en hardware Apple Silicon

Hammerspoon corre de forma nativa en Macs con chips Apple Silicon (M1, M2, M3 y sus variantes) e Intel, con optimizaciones específicas para la arquitectura ARM. Al operar sin polling constante y con un consumo estable por debajo de los 12 MB de RAM, no introduce degradación perceptible en laptops bajo restricciones de batería, un detalle que los founders que trabajan en movimiento aprecian.

Comunidad y recursos de aprendizaje

La comunidad de Hammerspoon está distribuida principalmente en:

GitHub: el repositorio oficial Hammerspoon/hammerspoon con issues, discusiones y el código fuente.
Hacker News: hilos recurrentes donde la comunidad comparte configs, casos de uso y comparativas con otras herramientas.
Dotfiles públicos: repositorios de configuración en GitHub donde otros usuarios comparten sus init.lua completos, una fuente práctica de aprendizaje por ejemplo.
YouTube: tutoriales que cubren desde el hello world hasta la automatización avanzada de GUI y scripting comparado con Keyboard Maestro.

¿Hammerspoon vs. alternativas de pago?

La pregunta que todo founder pragmático se hace es si la inversión de tiempo en aprender Lua vale frente a pagar por herramientas como Keyboard Maestro (~36 USD) o BetterTouchTool (licencia anual). La respuesta depende del perfil:

Si ya tienes familiaridad con scripting o programación, Hammerspoon devuelve esa inversión de aprendizaje con creces: control total, sin costos recurrentes y sin los 200–400 MB de RAM que consume software equivalente.
Si buscas una solución GUI sin código, herramientas como Shortcuts de macOS o Keyboard Maestro son más accesibles inicialmente.
Para equipos técnicos, la ventaja adicional de Hammerspoon es que las configuraciones se pueden versionar con Git, compartir entre el equipo y documentar como cualquier otro código.

Conclusión

Hammerspoon es una de esas herramientas que, una vez integrada en el flujo de trabajo, resulta difícil imaginar no tener. Para founders tech que operan en macOS, representa la posibilidad de construir un entorno de trabajo exactamente a su medida, sin compromisos, sin costos de licencia y sin renunciar al rendimiento. La curva de aprendizaje inicial de Lua es suave para cualquier persona con base en programación, y la comunidad activa garantiza que casi cualquier caso de uso ya tiene un punto de partida documentado.

Si el tiempo es tu recurso más escaso (y para un founder siempre lo es), automatizar las fricciones diarias de tu entorno de trabajo es una de las inversiones de mayor retorno que puedes hacer esta semana.

Descubre cómo otros founders implementan estas soluciones de automatización en su día a día y comparte tu propia configuración con nuestra comunidad.

Ver cómo lo hacen