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

tmuxinator

Edit tmuxinator YAML session files for windows, panes, and layouts.

Updated Aug 23, 2026
Search Tags:#configuration#session management#yaml#tmux#tmuxinator#pane layout
One-click install
npx skills add https://github.com/RyoMa99/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/dotfiles/tree/main/dot_claude/skills/tmuxinator
Command: npx skills add https://github.com/RyoMa99/dotfiles --skill tmuxinator-ryoma99

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines editing tmuxinator YAML session files so users can add, remove, or modify windows, panes, and layout ratios without manually hunting for the correct file or breaking YAML structure.

Core Features & Use Cases

  • Selects the target session file by using a provided filename, the default-project pointer, or an interactive selection when needed.
  • Performs safe YAML edits to add or remove windows, change pane commands, and update layouts, including converting ratio specifications like 9:1 into main-pane-width percentages.
  • Validates changes by showing the full updated configuration and recommending verification with tmuxinator debug; accommodates tmuxinator 3.x constraints such as avoiding window-level post hooks.

Quick Start

Ask to modify the tmuxinator session for project myproj to add a window named editor with two panes and set the pane ratio to 8:2 so the left pane becomes 80% of the width.

Frequently Asked Questions about tmuxinator

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

FAQPage Schema
How do I edit a tmuxinator session file to add a window with multiple panes?▼

Editing a tmuxinator session file involves modifying its YAML configuration to add windows and specify pane commands. This safely updates the session structure without breaking YAML syntax.

Can I set pane layout ratios like 9:1 in tmuxinator configuration?▼

Yes, tmuxinator configuration supports pane layout ratios. Ratio specifications like 9:1 are automatically converted into main-pane-width percentages to adjust the pane dimensions accordingly.

How do I validate changes after modifying a tmuxinator YAML file?▼

To validate changes after modifying a tmuxinator YAML file, you should use the tmuxinator debug command. This verifies that the updated configuration is structurally sound and functional.

Does tmuxinator 3.x support window-level post hooks in session configuration?▼

No, tmuxinator 3.x does not support window-level post hooks in session configuration. When editing YAML files, you must avoid these hooks to respect tmuxinator 3.x constraints.

What is the best way to select a specific tmuxinator session file for editing?▼

The best way to select a tmuxinator session file is by providing a filename directly. If unspecified, it uses the default-project pointer or prompts for interactive selection from the config directory.

Why do my tmuxinator pane commands not update correctly after manual YAML edits?▼

Tmuxinator pane commands may fail to update correctly after manual YAML edits due to syntax errors or invalid layout ratios. Performing safe YAML edits ensures commands and layouts update properly.

Related Skills

Explore More Software Engineering Skills→
trentshainestrentshaines
2

tmux

Manage tmux sessions, tmuxinator templates, and sesh workspaces.

Community
Intermediate
bastosbastos
6

tmuxinator

Orchestrate complex tmux sessions with windows, panes, layouts, and lifecycle hooks.

Community
Advanced
zhcndoczhcndoc

tmux

Send keystrokes and capture pane output in tmux sessions.

Official
Intermediate
runpodrunpod
24

tmux-tutorial

Provide an interactive step-by-step tutorial for learning tmux terminal multiplexer commands.

Official
Basic