tmux

Installation
SKILL.md

tmux Process Management

Session Reuse Rules

These are hard requirements, not suggestions:

  • MUST check tmux has-session before ever calling tmux new-session
  • MUST derive session name from git rev-parse --show-toplevel, never hardcode
  • MUST add windows to an existing project session, never create a parallel session
  • MUST use send-keys to run commands, never pass inline commands to new-session
  • NEVER create a new session if one already exists for the current project

One project = one tmux session. Multiple processes = multiple windows within that session.

Interactive Shell Requirement

Use send-keys pattern for reliable shell initialization. Creating a session spawns an interactive shell automatically. Use send-keys to run commands within that shell, ensuring PATH, direnv, and other initialization runs properly.

Related skills
Installs
83
GitHub Stars
47
First Seen
Feb 10, 2026