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.