What is hhtwm in the context of this skill?

hhtwm is a Hackable Hammer Tiling Window Manager for Hammerspoon that provides a structured layout system, allowing Claude to track and arrange windows logically.

Do I need to have Hammerspoon installed to use this skill?

Yes, this skill requires Hammerspoon to be installed on your macOS system and the 'hs' command-line tool to be configured in your path.

Can this skill handle multiple monitors?

Yes, the skill includes patterns for querying all connected screens and moving windows to specific frames on any available monitor.

Will using this skill automatically rearrange all my windows?

Not necessarily. The skill is designed to use a 'surgical' approach, moving only target windows unless you specifically invoke a full retile command.

How does Claude communicate with Hammerspoon?

Claude executes Lua code via the 'hs -c' shell command, which sends instructions directly to the Hammerspoon app running on your Mac.

Hammerspoon Window Control

Name: Hammerspoon Window Control
Author: mshuffett

bymshuffett

Productivity & Workflow

Automates macOS window layouts and tiling using Hammerspoon and hhtwm integration for precise desktop organization.

About

This skill empowers Claude to programmatically manage macOS window arrangements by combining the Hammerspoon automation engine with the hhtwm (Hackable Hammer Tiling Window Manager) system. It utilizes a hybrid approach that allows for surgical window positioning, layout switching, and workspace organization without disrupting existing tiling states. It is particularly useful for developers who want to automate their environment setup, create complex multi-app layouts, or manage window focus and positioning via natural language commands within Claude Code.

Key Features

Precise screen-relative window positioning and sizing
Predefined layout switching including main-left, monocle, and tabbed modes
Direct command execution via the Hammerspoon CLI integration
Hybrid tiling and manual window control using hhtwm state
Intelligent window discovery using application names and title patterns
0 GitHub stars

Use Cases

Creating persistent custom coding layouts with split-screen editors and terminals
Toggling specific windows between floating and tiled states programmatically
Batch organizing disparate application windows across multiple spaces and monitors

About

Key Features

Precise screen-relative window positioning and sizing
Predefined layout switching including main-left, monocle, and tabbed modes
Direct command execution via the Hammerspoon CLI integration
Hybrid tiling and manual window control using hhtwm state
Intelligent window discovery using application names and title patterns
0 GitHub stars

Use Cases

Creating persistent custom coding layouts with split-screen editors and terminals
Toggling specific windows between floating and tiled states programmatically
Batch organizing disparate application windows across multiple spaces and monitors