gum choose <options...>

Choose an option from a list of choices

Arguments

NameDescription
optionsOptions to choose from

Options

NameDescription
--height <lines>Height of the list
--cursor <symbol>Prefix to show on item that corresponds to the cursor position
--cursor-prefix <symbol>Prefix to show on the cursor item
--selected-prefix <symbol>Prefix to show on selected items
--unselected-prefix <symbol>Prefix to show on unselected items
--selected <option>
  • Repeatable ♾
--limit <number>Maximum number of options to pick
--no-limitPick unlimited number of options (ignores limit)
--cursor.background <color>Background Color for cursor
--cursor.foreground <color>Foreground Color for cursor
--cursor.border <arg>Border Style for cursor
--cursor.border-background <color>Border Background Color for cursor
--cursor.border-foreground <color>Border Foreground Color for cursor
--cursor.align <arg>Text Alignment for cursor
--cursor.height <lines>Text height for cursor
--cursor.width <width>Text width for cursor
--cursor.margin <margin>Text margin for cursor
--cursor.padding <padding>Text padding for cursor
--cursor.boldBold text for cursor
--cursor.faintFaint text for cursor
--cursor.italicItalicize text for cursor
--cursor.strikethroughStrikethrough text for cursor
--cursor.underlineUnderline text for cursor
--item.background <color>Background Color for item
--item.foreground <color>Foreground Color for item
--item.border <arg>Border Style for item
--item.border-background <color>Border Background Color for item
--item.border-foreground <color>Border Foreground Color for item
--item.align <arg>Text Alignment for item
--item.height <lines>Text height for item
--item.width <width>Text width for item
--item.margin <margin>Text margin for item
--item.padding <padding>Text padding for item
--item.boldBold text for item
--item.faintFaint text for item
--item.italicItalicize text for item
--item.strikethroughStrikethrough text for item
--item.underlineUnderline text for item
--selected.background <color>Background Color for selected
--selected.foreground <color>Foreground Color for selected
--selected.border <arg>Border Style for selected
--selected.border-background <color>Border Background Color for selected
--selected.border-foreground <color>Border Foreground Color for selected
--selected.align <arg>Text Alignment for selected
--selected.height <lines>Text height for selected
--selected.width <width>Text width for selected
--selected.margin <margin>Text margin for selected
--selected.padding <padding>Text padding for selected
--selected.boldBold text for selected
--selected.faintFaint text for selected
--selected.italicItalicize text for selected
--selected.strikethroughStrikethrough text for selected
--selected.underlineUnderline text for selected