Tmux Processes

What it does

This skill enables AI agents to manage and monitor Tmux sessions, facilitating remote server administration tasks. It allows for creating new sessions, sending commands within those sessions via an interactive shell (essential for proper environment initialization), adding windows to existing sessions, and capturing output from specific panes or the entire session. The skill emphasizes using tmux send-keys to ensure commands are executed within a properly initialized shell environment.

When to use it

• Starting development servers on remote machines where environment setup is crucial (e.g., using direnv).
• Running automated tests in separate Tmux windows alongside a main server process.
• Monitoring application logs and checking for errors or readiness indicators within a Tmux session.
• Creating multiple processes within a single project, organized into different Tmux windows.
• Ensuring commands are executed with the correct environment variables by using an interactive shell.

Key capabilities

• Creation of new Tmux sessions with named windows.
• Sending commands to existing Tmux sessions via tmux send-keys.
• Adding new windows to existing Tmux sessions.
• Capturing output from specific panes or entire sessions.
• Checking for the existence of sessions and windows before creating them (idempotent operations).
• Deriving session names automatically based on project directory.

Example prompts

• "Create a Tmux session named 'myapp' with a window called 'server' and run npm run dev."
• "Check the last 50 lines of output from the 'logs' window in the 'myapp' session for any errors."
• "Add a new window to the 'myapp' session named 'tests' and execute npm run test:watch."

Tips & gotchas

• Interactive Shell Requirement: This skill requires an interactive shell environment. Use tmux send-keys instead of directly executing commands with tmux new-session.
• Session Naming Convention: Session names should be derived from the project directory to maintain consistency.
• Idempotency: The skill provides mechanisms for checking if a session or window already exists before attempting to create it, preventing errors and ensuring consistent state.