gum-beautifylisted

# Gum Terminal UX Integration Integrate Charmbracelet's `gum` CLI tool into bash scripts for beautiful terminal output, interactive prompts, and structured logging -- with mandatory TTY detection to ensure scripts remain pipe-safe. ## When to Use - User requests interactive prompts (selection menus, confirmations, text input) - Script needs visually styled output (headers, banners, success/error messages) - Structured logging is needed (`gum log` with levels and key-value pairs) - Progress indication for long-running operations (spinners) - User wants a polished CLI experience for their bash tools - Existing scripts need UX improvements without changing functionality ## Prerequisites 1. **gum is installed**: The script must verify gum is available at runtime. This skill provides the detection boilerplate but does NOT handle gum installation -- the script should fail with a clear message directing the user to install gum. 2. **Bash 4+**: Gum integration patterns use bash-specific features (`[[ ]]` tests, process substitution). ## Gum Subcommand Reference | Subcommand | Purpose | Needs TTY stdin | Output | |------------|---------|-----------------|--------| | `gum input` | Single-line text input | Yes | stdout | | `gum write` | Multi-line text editor | Yes | stdout | | `gum filter` | Fuzzy filter from list | Yes | stdout | | `gum choose` | Select from options | Yes | stdout | | `gum confirm` | Yes/no confirmation | Yes | exit code | | `gum file` | File picker | Yes | std