What problem does it solve?
Manually setting up multiple terminal sessions, windows, and panes for parallel tasks or running separate agents in different worktrees is tedious and prone to errors, especially when ensuring each terminal opens in the correct project directory.
Core Features & Use Cases
- Tmux State Inspection: List existing tmux sessions, windows, and panes to get an overview of active terminal workflows.
- Worktree-Aligned Agent Launching: Create new tmux windows or split panes directly in specified worktree directories to run separate pi agents for parallel development.
- Terminal Layout Automation: Apply tiled layouts, rename windows, send commands to existing panes, and clean up unused terminal resources to streamline repetitive setup tasks.
- Use Case: For example, if you are working on a feature branch in a git worktree and need to run a long test suite in a separate terminal while keeping your main session active, this skill automates creating the dedicated pane in the correct worktree directory.
Quick Start
Use the tmux skill to create a new tmux window in your current session that starts a pi agent in the specified worktree directory.