skills.rest
RyoMa99
RyoMa99COMMUNITY
Explore all skills by this author →
GitHub

tmuxinator

Edits tmuxinator YAML configurations for windows, panes, layouts, and pane ratios.

Updated Jan 30, 2026
Search Tags:#dotfiles#session management#yaml#tmux#terminal#tmuxinator#pane layout
One-click install
npx skills add https://github.com/RyoMa99/chezmoi_dotfiles --skill tmuxinator-ryoma99
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tmuxinator
Source: https://github.com/RyoMa99/chezmoi_dotfiles/tree/main/dot_claude/skills/tmuxinator
Command: npx skills add https://github.com/RyoMa99/chezmoi_dotfiles --skill tmuxinator-ryoma99

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Editing tmuxinator YAML files by hand is error-prone, especially around tmuxinator 3.x quirks like the ignored window-level post key and pane ratio control via main-pane-width. This Skill guides safe, verified edits to tmux session configurations. ## Core Features & Use Cases - Window and Pane Management: Add, remove, or edit windows and pane commands in ~/.config/tmuxinator/*.yml files. - Pane Ratio Control: Convert ratio requests like 8:2 into main-pane-width percentages applied via on_project_start, avoiding the broken post key approach. - Verification Workflow: Validate every change with tmuxinator debug and review the generated shell script before applying. - Use Case: Ask to add a new window running nvim in a project directory with a 70/30 main-vertical split, and the Skill locates the right yml, edits it, and verifies the result. ## Quick Start Ask the assistant to add a new window with a specific pane layout to your default tmuxinator project configuration.

Frequently Asked Questions about tmuxinator

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

FAQPage Schema
How do I change pane ratios in tmuxinator?▼

Set the layout to main-vertical and add on_project_start with tmux set-option -g main-pane-width followed by a percentage. For example, an 8:2 ratio becomes 80%. Do not use the window-level post key, which tmuxinator 3.x ignores.

How do I add a window to a tmuxinator configuration?▼

Append a new window block to the windows list in the project yml file under ~/.config/tmuxinator. Each window can define its own layout, panes list, and an optional root directory that overrides the session default.

Why is my tmuxinator post command not running?▼

In tmuxinator 3.3 and later, the window-level post key is silently ignored, so resize commands placed there never execute. Move the logic into on_project_start using tmux set-option for main-pane-width or main-pane-height instead.

How do I verify tmuxinator config changes before applying them?▼

Run tmuxinator debug with the session name to print the generated shell script and confirm the commands match your intent. If the session is already running, stop and restart it with tmuxinator stop and start for changes to take effect.

Can tmuxinator windows use different working directories?▼

Yes, each window supports its own root key that overrides the session-level default directory. Set root under the specific window block to open its panes in a different project path.

Related Skills

Explore More Software Engineering Skills→
RyoMa99RyoMa99

tmuxinator

Edits tmuxinator YAML configurations for windows, panes, layouts, and pane ratios.

Community
Intermediate
trentshainestrentshaines
2

tmux

Manage tmux sessions, tmuxinator templates, and sesh workspaces.

Community
Intermediate
shepherdjerredshepherdjerred
127

chezmoi-helper

Manage dotfiles across multiple machines using Chezmoi declarative configuration, templates, and secrets.

Community
Advanced
tartinerlabstartinerlabs
7

setup

Automate JavaScript and TypeScript project setup with linting, formatting, and git hooks.

Official
Intermediate