tmux

Create and manage tmux sessions, windows, and panes for terminal workflows.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/hschne/pi-stuff --skill tmux-hschne
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux
Source: https://github.com/hschne/pi-stuff/tree/main/skills/tmux
Command: npx skills add https://github.com/hschne/pi-stuff --skill tmux-hschne

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about tmux

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

FAQPage Schema
How do I automate tmux session management for parallel development workflows?

Automate tmux session management by using this skill to create, inspect, and manage sessions, windows, and panes. It reduces manual command entry for terminal orchestration and organizes parallel terminal layouts for development workflows.

Can I launch separate agents in git worktrees using tmux pane management?

Yes, you can launch separate agents in git worktrees by creating new tmux windows or split panes directly in specified worktree directories. This enables safe session resource management and parallel agent execution.

What is the best way to organize terminal layouts across multiple project directories?

Organizing terminal layouts across multiple project directories is handled by applying tiled layouts, renaming windows, and sending commands to existing panes. This terminal layout automation streamlines repetitive setup steps for development.

How do I inspect active tmux sessions, windows, and panes during development?

You can inspect active tmux sessions, windows, and panes by listing existing terminal workflows. This tmux state inspection provides an overview of active terminal workflows and helps manage session resources safely.

Does terminal multiplexing work with directory-specific launching for git worktrees?

Terminal multiplexing supports directory-specific launching by creating new tmux windows that start directly in specified git worktree directories. This satisfies requirements for directory-specific terminal launching and reduced manual command entry.

What are the limitations of automating terminal setup steps with tmux?

Automating terminal setup steps with tmux requires existing tmux session infrastructure to manage windows and panes effectively. Limitations include dependency on tmux availability and the need for correct worktree directory paths to ensure safe session resource management.