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.