tmuxinator

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

6|Updated Jan 12, 2026

Search Tags:#automation #development #tmux #sessions #tmuxinator #windows #panes

Ready to run

npx skills add https://github.com/bastos/skills --skill tmuxinator

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: tmuxinator
Source: https://github.com/bastos/skills/tree/main/tmuxinator
Command: npx skills add https://github.com/bastos/skills --skill tmuxinator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Tmuxinator helps developers manage and automate complex tmux sessions with multiple windows and panes, reducing manual setup time and errors.

Core Features & Use Cases

Create, edit, and debug tmuxinator project configurations for complex session layouts.
Define windows, panes, layouts, startup commands, and lifecycle hooks to reproduce environments across machines.
Use cases include setting up multi-window development environments, debugging layout issues, and sharing reusable configurations across teams.

Quick Start

Install tmuxinator, create a sample PROJECT.yml in your project, and run tmuxinator start PROJECT to launch the configured session.

Frequently Asked Questions about tmuxinator

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

FAQPage Schema

How do I automate complex tmux sessions with multiple windows and panes?▼

You can automate complex tmux sessions by defining project configurations in YAML files. These configurations manage windows, panes, layouts, and startup commands, allowing you to reproduce development environments across machines effortlessly.

What is the best way to reproduce development environments across machines using tmux?▼

Reproducing development environments across machines involves creating reusable tmux session configurations. By defining multi-window and multi-pane layouts with specific startup commands in a project file, you ensure consistent setups across different machines.

Can I run specific commands before or after starting a tmux window?▼

Yes, you can run specific commands before or after starting a tmux window. The configuration supports lifecycle hooks, allowing you to execute predefined commands automatically when windows are created or destroyed.

How do I debug layout issues in my tmux session configurations?▼

To debug layout issues in your tmux session configurations, you can edit and test your project YAML files. This process helps identify misaligned panes or incorrect window setups, ensuring your terminal layout functions as intended.

Do I need to install tmux to manage multi-pane terminal layouts?▼

Yes, you need to install tmux because these configurations orchestrate tmux sessions directly. The setup relies on tmux to manage the underlying windows, panes, and terminal multiplexing for your development environment.