Skills
.Work. You
Rest

tmux-pane-geometry

Community

Turn tmux pane layouts into precise geometry.

Software Engineering#tmux#overlay#pane-geometry#pixel-coordinates#terminal-layout#diff-events
Authorhafley66
Version1.0.0
Installs0

System Documentation

What problem does it solve?

tmux pane layouts are difficult to map to screen coordinates and detect layout changes across panes. This skill provides tooling to query pane geometry, convert cell coordinates to pixel measurements, and monitor layout changes over time.

Core Features & Use Cases

  • Query pane geometry with tmux list-panes and parse into a structured form.
  • Convert cell coordinates to screen pixels using TIOCGWINSZ ioctl with fallbacks to CSI 16t, including retina-aware scaling and terminal insets handling.
  • Track pane changes via diff events (Added, Moved, Resized, Removed) and support push-based updates via hooks.
  • Use in overlay-style applications to position UI elements relative to the terminal grid.

Quick Start

Run the tmux-pane-geometry workflow to query current pane geometry and compute pixel-based overlay positions.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: tmux-pane-geometry
Download link: https://github.com/hafley66/claude-research/archive/main.zip#tmux-pane-geometry

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.