tmux-mastery

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.