GUM(1) A tool for glamorous shell scripts. GUM(1) NAME gum - A tool for glamorous shell scripts. SYNOPSIS gum [options...] [argument...] DESCRIPTION OPTIONS -h, --help Show context-sensitive help. -v, --version Print the version number COMMANDS choose [ ...] [flags] Choose an option from a list of choices OPTIONS --cursor-prefix="o " Prefix to show on the cursor item (hidden if limit is 1) --cursor.align="left" Text Alignment --cursor.background="" Background Color --cursor.bold Bold text --cursor.border-background="" Border Background Color --cursor.border-foreground="" Border Foreground Color --cursor.border="none" Border Style --cursor.faint Faint text --cursor.foreground="212" Foreground Color --cursor.height=0 Text height --cursor.italic Italicize text --cursor.margin="0 0" Text margin --cursor.padding="0 0" Text padding --cursor.strikethrough Strikethrough text --cursor.underline Underline text --cursor.width=0 Text width --cursor="> " Prefix to show on item that corresponds to the cursor position --header.align="left" Text Alignment --header.background="" Background Color --header.bold Bold text --header.border-background="" Border Background Color --header.border-foreground="" Border Foreground Color --header.border="none" Border Style --header.faint Faint text --header.foreground="99" Foreground Color --header.height=0 Text height --header.italic Italicize text --header.margin="0 0" Text margin --header.padding="0 0" Text padding --header.strikethrough Strikethrough text --header.underline Underline text --header.width=0 Text width --header="" Header value --height=10 Height of the list --item.align="left" Text Alignment --item.background="" Background Color --item.bold Bold text --item.border-background="" Border Background Color --item.border-foreground="" Border Foreground Color --item.border="none" Border Style --item.faint Faint text --item.foreground="" Foreground Color --item.height=0 Text height --item.italic Italicize text --item.margin="0 0" Text margin --item.padding="0 0" Text padding --item.strikethrough Strikethrough text --item.underline Underline text --item.width=0 Text width --limit=1 Maximum number of options to pick --no-limit Pick unlimited number of options (ignores limit) --ordered Maintain the order of the selected options --select-if-one Select the given option if there is only one --selected-prefix="\/ " Prefix to show on selected items (hidden if limit is 1) --selected.align="left" Text Alignment --selected.background="" Background Color --selected.bold Bold text --selected.border-background="" Border Background Color --selected.border-foreground="" Border Foreground Color --selected.border="none" Border Style --selected.faint Faint text --selected.foreground="212" Foreground Color --selected.height=0 Text height --selected.italic Italicize text --selected.margin="0 0" Text margin --selected.padding="0 0" Text padding --selected.strikethrough Strikethrough text --selected.underline Underline text --selected.width=0 Text width --selected=,... Options that should start as selected --timeout=0 Timeout until choose returns selected element --unselected-prefix="o " Prefix to show on unselected items (hidden if limit is 1) confirm [] [flags] Ask a user to confirm an action OPTIONS --affirmative="Yes" The title of the affirmative action --default Default confirmation action --negative="No" The title of the negative action --prompt.align="left" Text Alignment --prompt.background="" Background Color --prompt.bold Bold text --prompt.border-background="" Border Background Color --prompt.border-foreground="" Border Foreground Color --prompt.border="none" Border Style --prompt.faint Faint text --prompt.foreground="" Foreground Color --prompt.height=0 Text height --prompt.italic Italicize text --prompt.margin="1 0 0 1" Text margin --prompt.padding="0 0" Text padding --prompt.strikethrough Strikethrough text --prompt.underline Underline text --prompt.width=0 Text width --selected.align="left" Text Alignment --selected.background="212" Background Color --selected.bold Bold text --selected.border-background="" Border Background Color --selected.border-foreground="" Border Foreground Color --selected.border="none" Border Style --selected.faint Faint text --selected.foreground="230" Foreground Color --selected.height=0 Text height --selected.italic Italicize text --selected.margin="0 1" Text margin --selected.padding="0 3" Text padding --selected.strikethrough Strikethrough text --selected.underline Underline text --selected.width=0 Text width --timeout=0 Timeout until confirm returns selected value or default if provided --unselected.align="left" Text Alignment --unselected.background="235" Background Color --unselected.bold Bold text --unselected.border-background="" Border Background Color --unselected.border-foreground="" Border Foreground Color --unselected.border="none" Border Style --unselected.faint Faint text --unselected.foreground="254" Foreground Color --unselected.height=0 Text height --unselected.italic Italicize text --unselected.margin="0 1" Text margin --unselected.padding="0 3" Text padding --unselected.strikethrough Strikethrough text --unselected.underline Underline text --unselected.width=0 Text width file [] [flags] Pick a file from a folder OPTIONS -a, --all Show hidden and 'dot' files --cursor.align="left" Text Alignment --cursor.background="" Background Color --cursor.bold Bold text --cursor.border-background="" Border Background Color --cursor.border-foreground="" Border Foreground Color --cursor.border="none" Border Style --cursor.faint Faint text --cursor.foreground="212" Foreground Color --cursor.height=0 Text height --cursor.italic Italicize text --cursor.margin="0 0" Text margin --cursor.padding="0 0" Text padding --cursor.strikethrough Strikethrough text --cursor.underline Underline text --cursor.width=0 Text width -c, --cursor=">" The cursor character --directory Allow directories selection --directory.align="left" Text Alignment --directory.background="" Background Color --directory.bold Bold text --directory.border-background="" Border Background Color --directory.border-foreground="" Border Foreground Color --directory.border="none" Border Style --directory.faint Faint text --directory.foreground="99" Foreground Color --directory.height=0 Text height --directory.italic Italicize text --directory.margin="0 0" Text margin --directory.padding="0 0" Text padding --directory.strikethrough Strikethrough text --directory.underline Underline text --directory.width=0 Text width --file Allow files selection --file-size.align="right" Text Alignment --file-size.background="" Background Color --file-size.bold Bold text --file-size.border-background="" Border Background Color --file-size.border-foreground="" Border Foreground Color --file-size.border="none" Border Style --file-size.faint Faint text --file-size.foreground="240" Foreground Color --file-size.height=0 Text height --file-size.italic Italicize text --file-size.margin="0 0" Text margin --file-size.padding="0 0" Text padding --file-size.strikethrough Strikethrough text --file-size.underline Underline text --file-size.width=8 Text width --file.align="left" Text Alignment --file.background="" Background Color --file.bold Bold text --file.border-background="" Border Background Color --file.border-foreground="" Border Foreground Color --file.border="none" Border Style --file.faint Faint text --file.foreground="" Foreground Color --file.height=0 Text height --file.italic Italicize text --file.margin="0 0" Text margin --file.padding="0 0" Text padding --file.strikethrough Strikethrough text --file.underline Underline text --file.width=0 Text width --height=10 Maximum number of files to display --permissions.align="left" Text Alignment --permissions.background="" Background Color --permissions.bold Bold text --permissions.border-background="" Border Background Color --permissions.border-foreground="" Border Foreground Color --permissions.border="none" Border Style --permissions.faint Faint text --permissions.foreground="244" Foreground Color --permissions.height=0 Text height --permissions.italic Italicize text --permissions.margin="0 0" Text margin --permissions.padding="0 0" Text padding --permissions.strikethrough Strikethrough text --permissions.underline Underline text --permissions.width=0 Text width --selected.align="left" Text Alignment --selected.background="" Background Color --selected.bold Bold text --selected.border-background="" Border Background Color --selected.border-foreground="" Border Foreground Color --selected.border="none" Border Style --selected.faint Faint text --selected.foreground="212" Foreground Color --selected.height=0 Text height --selected.italic Italicize text --selected.margin="0 0" Text margin --selected.padding="0 0" Text padding --selected.strikethrough Strikethrough text --selected.underline Underline text --selected.width=0 Text width --symlink.align="left" Text Alignment --symlink.background="" Background Color --symlink.bold Bold text --symlink.border-background="" Border Background Color --symlink.border-foreground="" Border Foreground Color --symlink.border="none" Border Style --symlink.faint Faint text --symlink.foreground="36" Foreground Color --symlink.height=0 Text height --symlink.italic Italicize text --symlink.margin="0 0" Text margin --symlink.padding="0 0" Text padding --symlink.strikethrough Strikethrough text --symlink.underline Underline text --symlink.width=0 Text width --timeout=0 Timeout until command aborts without a selection filter [ ...] [flags] Filter items from a list OPTIONS --cursor-text.align="left" Text Alignment --cursor-text.background="" Background Color --cursor-text.bold Bold text --cursor-text.border-background="" Border Background Color --cursor-text.border-foreground="" Border Foreground Color --cursor-text.border="none" Border Style --cursor-text.faint Faint text --cursor-text.foreground="" Foreground Color --cursor-text.height=0 Text height --cursor-text.italic Italicize text --cursor-text.margin="0 0" Text margin --cursor-text.padding="0 0" Text padding --cursor-text.strikethrough Strikethrough text --cursor-text.underline Underline text --cursor-text.width=0 Text width --fuzzy Enable fuzzy matching --header.align="left" Text Alignment --header.background="" Background Color --header.bold Bold text --header.border-background="" Border Background Color --header.border-foreground="" Border Foreground Color --header.border="none" Border Style --header.faint Faint text --header.foreground="240" Foreground Color --header.height=0 Text height --header.italic Italicize text --header.margin="0 0" Text margin --header.padding="0 0" Text padding --header.strikethrough Strikethrough text --header.underline Underline text --header.width=0 Text width --header="" Header value --height=0 Input height --indicator.align="left" Text Alignment --indicator.background="" Background Color --indicator.bold Bold text --indicator.border-background="" Border Background Color --indicator.border-foreground="" Border Foreground Color --indicator.border="none" Border Style --indicator.faint Faint text --indicator.foreground="212" Foreground Color --indicator.height=0 Text height --indicator.italic Italicize text --indicator.margin="0 0" Text margin --indicator.padding="0 0" Text padding --indicator.strikethrough Strikethrough text --indicator.underline Underline text --indicator.width=0 Text width --indicator="o" Character for selection --limit=1 Maximum number of options to pick --match.align="left" Text Alignment --match.background="" Background Color --match.bold Bold text --match.border-background="" Border Background Color --match.border-foreground="" Border Foreground Color --match.border="none" Border Style --match.faint Faint text --match.foreground="212" Foreground Color --match.height=0 Text height --match.italic Italicize text --match.margin="0 0" Text margin --match.padding="0 0" Text padding --match.strikethrough Strikethrough text --match.underline Underline text --match.width=0 Text width --no-limit Pick unlimited number of options (ignores limit) --placeholder.align="left" Text Alignment --placeholder.background="" Background Color --placeholder.bold Bold text --placeholder.border-background="" Border Background Color --placeholder.border-foreground="" Border Foreground Color --placeholder.border="none" Border Style --placeholder.faint Faint text --placeholder.foreground="240" Foreground Color --placeholder.height=0 Text height --placeholder.italic Italicize text --placeholder.margin="0 0" Text margin --placeholder.padding="0 0" Text padding --placeholder.strikethrough Strikethrough text --placeholder.underline Underline text --placeholder.width=0 Text width --placeholder="Filter..." Placeholder value --prompt.align="left" Text Alignment --prompt.background="" Background Color --prompt.bold Bold text --prompt.border-background="" Border Background Color --prompt.border-foreground="" Border Foreground Color --prompt.border="none" Border Style --prompt.faint Faint text --prompt.foreground="240" Foreground Color --prompt.height=0 Text height --prompt.italic Italicize text --prompt.margin="0 0" Text margin --prompt.padding="0 0" Text padding --prompt.strikethrough Strikethrough text --prompt.underline Underline text --prompt.width=0 Text width --prompt="> " Prompt to display --reverse Display from the bottom of the screen --select-if-one Select the given option if there is only one --selected-indicator.align="left" Text Alignment --selected-indicator.background="" Background Color --selected-indicator.bold Bold text --selected-indicator.border-background="" Border Background Color --selected-indicator.border-foreground="" Border Foreground Color --selected-indicator.border="none" Border Style --selected-indicator.faint Faint text --selected-indicator.foreground="212" Foreground Color --selected-indicator.height=0 Text height --selected-indicator.italic Italicize text --selected-indicator.margin="0 0" Text margin --selected-indicator.padding="0 0" Text padding --selected-indicator.strikethrough Strikethrough text --selected-indicator.underline Underline text --selected-indicator.width=0 Text width --selected-prefix=" " Character to indicate selected items (hidden if limit is 1) --sort Sort the results --strict Only returns if anything matched. Otherwise return Filter --text.align="left" Text Alignment --text.background="" Background Color --text.bold Bold text --text.border-background="" Border Background Color --text.border-foreground="" Border Foreground Color --text.border="none" Border Style --text.faint Faint text --text.foreground="" Foreground Color --text.height=0 Text height --text.italic Italicize text --text.margin="0 0" Text margin --text.padding="0 0" Text padding --text.strikethrough Strikethrough text --text.underline Underline text --text.width=0 Text width --timeout=0 Timeout until filter command aborts --unselected-prefix.align="left" Text Alignment --unselected-prefix.background="" Background Color --unselected-prefix.bold Bold text --unselected-prefix.border-background="" Border Background Color --unselected-prefix.border-foreground="" Border Foreground Color --unselected-prefix.border="none" Border Style --unselected-prefix.faint Faint text --unselected-prefix.foreground="240" Foreground Color --unselected-prefix.height=0 Text height --unselected-prefix.italic Italicize text --unselected-prefix.margin="0 0" Text margin --unselected-prefix.padding="0 0" Text padding --unselected-prefix.strikethrough Strikethrough text --unselected-prefix.underline Underline text --unselected-prefix.width=0 Text width --unselected-prefix=" O " Character to indicate unselected items (hidden if limit is 1) --value="" Initial filter value --width=20 Input width format [