💪 What

• Files Created:
  • lib/tmux-utils.bash - Tmux/TPM utility functions (3 functions, 4 tests)
  • bin/install/tmux.bash - Bash replacement for tmux.zsh
  • test/install/test-tmux-utils.bats - 4 utility function tests
  • test/install/test-tmux-installation.bats - 3 integration tests
• Files Updated:
  • setup.bash - Added tmux.bash integration after neovim.bash
  • .claude/tasks/2025-07-07-bash-migration.md - Updated with PR Migrate Tmux installation to bash with TPM support #26 progress
• Test Coverage: 7 comprehensive tests covering all functionality
• Quality: 7/7 tests passing, zero shellcheck warnings

🤔 Why

• Bash Migration: Part of migration from custom zsh to industry-standard bash + shellcheck + bats
• Professional Tooling: Enables shellcheck linting and bats testing for Tmux installation
• Shared Utilities: Extracts reusable TPM management logic
• Setup Integration: Ensures parallel bash setup flow includes tmux installation
• Simplified: Removes commented-out terminfo installation code

👀 Usage

Run Tmux installation:

./bin/install/tmux.bash

Features:

• Checks if TPM already installed (skips clone if present)
• Clones tmux-plugins/tpm repository via SSH
• Runs TPM's install_plugins script
• Installs all plugins defined in tmux.conf

👩‍🔬 How to validate

Run utility tests:

bats test/install/test-tmux-utils.bats

Run integration tests:

bats test/install/test-tmux-installation.bats

Expected output (7 tests total):

# Utility tests
1..4
ok 1 tpm_installed returns false when TPM not found
ok 2 tpm_installed returns true when TPM exists
ok 3 install_tpm clones TPM repository
ok 4 install_tpm_plugins runs install_plugins script

# Integration tests
1..3
ok 1 tmux.bash exists and is executable
ok 2 tmux.bash skips TPM installation when already installed
ok 3 tmux.bash installs TPM and plugins when not present

Verify shellcheck compliance:

shellcheck lib/tmux-utils.bash bin/install/tmux.bash

Verify setup.bash integration:

grep -A 5 -B 5 "tmux.bash" setup.bash

Architecture

Functions Provided:

• tpm_installed() - Checks if TPM directory exists
• install_tpm() - Clones TPM repository
• install_tpm_plugins() - Runs TPM's install_plugins script

Key Features:

• TPM Management: Full Tmux Plugin Manager support
• Plugin Installation: Automatic plugin installation from config
• Idempotent: Skips TPM clone if already installed
• Standard Paths: Uses ~/.config/tmux/plugins/tpm

Setup Integration (setup.bash updates)

Added tmux.bash integration:

• Positioned after neovim.bash in installation sequence
• Follows same conditional pattern as other bash scripts
• Maintains parallel development strategy for bash migration

This ensures the parallel bash setup flow includes tmux installation, completing another major component of the bash migration epic.

🔗 Related links

• Bash Migration Epic
• Original tmux.zsh
• TPM Documentation - Tmux Plugin Manager

Implementation Details

TDD Approach:

• 7 test cases following strict TDD methodology
• Comprehensive mocking for git and plugin scripts
• Both unit and integration test coverage
• Behavioral testing focus

Migration Benefits:

• Professional tooling (shellcheck + bats)
• Better error handling with strict mode
• Comprehensive test coverage
• Cleaner implementation (removed commented code)

Simplifications:

• Removed terminfo installation (commented in original)
• Focused on core TPM functionality
• Clear separation of concerns