tmux-mastery

Manage tmux sessions and orchestrate processes with send-keys and TPM.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides practical, repeatable guidance for running and monitoring development processes inside tmux while also making it easy to configure a polished visual environment and plugin stack. It reduces mistakes like launching inline commands that bypass shell initialization, prevents destructive session-wide operations, and standardizes session naming and lifecycle handling across projects.

Core Features & Use Cases

  • Process orchestration: Idempotent session startup, window-based multi-process layouts, and reliable send-keys usage to ensure shell init and direnv are applied.
  • Monitoring & lifecycle: Commands and patterns for capturing pane output, polling for readiness, safe session listing, and non-destructive session cleanup.
  • Ricing & UX: Recommended minimal configs, a curated plugin stack, Catppuccin theme integration, and fuzzy session/floating pane tools for improved workflow.
  • Use case: Start a project-named tmux session, run a dev server in one window, a test watcher in another, and use the floax scratch pane for quick commands while preserving persistent session state.

Quick Start

Start a tmux session named after your project and launch the main dev server in a window using send-keys so the shell initializes correctly.

Frequently Asked Questions about tmux-mastery

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

FAQPage Schema
How do I start a tmux session named after my git root directory?

You can start an idempotent tmux session named after your project's git root directory to standardize session naming and lifecycle handling across your development workflows, preventing naming conflicts and duplicate sessions.

Why does my tmux send-keys command bypass shell initialization and direnv?

Using tmux send-keys incorrectly can bypass shell initialization and direnv. Proper send-keys usage ensures the shell initializes correctly before executing commands, preventing environment variable misconfigurations in your development processes.

What is the best way to manage multiple development processes in tmux windows?

The best way to manage multiple development processes in tmux is using window-based multi-process layouts. This allows you to run a dev server in one window and a test watcher in another while monitoring pane output.

Can I configure the Catppuccin theme and TPM plugins for tmux?

Yes, you can configure the Catppuccin theme and manage TPM plugins for tmux. Applying recommended minimal configs and a curated plugin stack improves ricing and visual environment setup for your sessions.

How do I safely clean up and list tmux sessions without destroying active work?

You can safely list and clean up tmux sessions using non-destructive lifecycle commands. These safe operations prevent destructive session-wide actions and preserve persistent session state during cleanup.

Does tmux process orchestration support polling for service readiness?

Yes, tmux process orchestration supports polling for service readiness. You can capture pane output and monitor it to verify when development servers or background processes are fully initialized and ready.