v0.9.0

Customize Format Theme 🎀

This brand new release of Gum features minor improvements and additional options, as well as some sweet bug fixes!

With v0.9.0, you can now customize your glamour theme to make gum format even more glamorous.

To get started just run one of the following:

gum format --theme dark < README.md

gum format --theme dracula < README.md

gum format --theme notty < README.md

Note
You can also pass your own custom glamour JSON theme file to the --theme flag for even more customization.

New Features

• gum choose now supports ctrl+j / ctrl+k keybindings
• gum choose can use tab to toggle selection
• add --file / --directory flags to select each in gum file
• ability to add --header values for textinput
• gum pager --soft-wrap option
• gum style pass input to style over stdin
• allow customization of glamour theme in gum format

Bug fixes

• --all option defaults to false (matching ls)
• exit with status 130 if escape key press on gum write
• symlink directory follows link in gum file
• allow exact match (non-fuzzy) in gum filter

Full Changelog: v0.8.0...v0.9.0

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.8.0

Brand New Flavours!

Version v0.8.0 of Gum comes packed with three brand-new gum subcommands, as well as a handful of other fixes and improvements.

• Gum File
• Gum Table
• Gum Pager

File

gum file [directory]

With this new gum sub-command, you can prompt users to select a file, which returns the absolute path of the file selected.
The command will start in the current directory or the directory passed as an argument but users may traverse the file tree up or down.

Table

gum table < table.csv

Display and select a row of tabular data with gum table.

Pager

gum pager < README.md

Scroll through long form content with gum pager.

Changelog

New Features

• 2bea4dc: feat(file): gum file to pick files (@maaslalani)
• a82d5af: feat(filter): add reverse layout (#177) (@dhruvmanila)
• 430ab45: feat(pager): gum pager for scrolling through long documents (@maaslalani)
• bdd86d5: feat(table): gum table for tabular data (@maaslalani)
• f13b5b6: feat(write): use --header to display a label above the textarea (@keevan)

Bug fixes

• a4d4793: fix(confirm): an empty --negative will not be displayed (@keevan)

Full Changelog: v0.7.0...v0.8.0

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Slack.

v0.7.0

Pre-selected Entries and Spinner Alignments!

• choose: --selected flag to preselect entries in gum choose by @vanielf in #112
• filter: shift+tab toggles selection and moves up in gum filter --no-limit @dhruvmanila in #167
• spin: --align (left|right) places spinner to the right or left of the title by @gregkh in #164

Full Changelog: v0.6.0...v0.7.0

New Contributors

• @vanielf made their first contribution in #112
• @IllustratedMan-code made their first contribution in #123
• @eetann made their first contribution in #144
• @dependabot made their first contribution in #159
• @solomon-b made their first contribution in #160
• @NNBnh made their first contribution in #163
• @dhruvmanila made their first contribution in #167
• @mathaou made their first contribution in #166
• @gregkh made their first contribution in #164

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Slack.

v0.6.0

Gum Filter Multi-select

Gum filter can now accept a --limit (defaults to 1) or --no-limit flag for allowing multiple selections during a filter. If the limit is greater than 1 (or --no-limit) you can press tab to select an item and press enter to confirm all the selections.

gum filter --no-limit

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Slack.

v0.5.0

Changelog

New Features

• g / G go to the beginning and end of gum choose lists
• Pressing down on the last element or up on the first element will wrap around a gum choose list
• Confirm messages now contain timeouts to allow for non-interactive continuation.

Bug fixes

• 2d5ef9: fix: gum write --char-limit 0 should ignore limit (@maaslalani)
• 4e61c1: fix: run spinner on stderr (@maaslalani)

Others

• 9b3c8c: Allow --value to pre-populate gum filter (#113) (@maaslalani)

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Slack.

v0.4.0

Gum Themes!

You can now configure Gum to use default styling for different commands with $ENVIRONMENT_VARIABLES. Gum will use this configuration by default (--flags can override these settings):

For example, gum filter can be customized with the following:

export GUM_FILTER_INDICATOR="*"
export GUM_FILTER_INDICATOR_FOREGROUND=1
export GUM_FILTER_PROMPT="→"
export GUM_FILTER_PROMPT_FOREGROUND=1

# command will now use default customization from the environment variables but
# can still be overridden by flags.
gum filter

New Features

• --char-limit flag is now available on gum write and gum input to limit the number of characters typed into the inputs.

Bug Fixes

• Fix readability on light theme for gum confirm
• gum style --help now lists all flags available
• gum filter uses alternative screen buffer if no --height is specified to preserve screen history when it exits (with --height flag it runs inline)

Full Changelog: v0.3.0...v0.4.0

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Slack.

v0.3.0

Changelog

New Features

• gum filter can now take a --height to limit viewable options and can now scroll through options
• gum spin --show-output returns stderr as well as stdout
• You can select all options with gum choose --no-limit by pressing a/A

Bug Fixes

• Fixed bug with paging up on gum choose

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Slack.

v0.2.0

What's Changed

• Determine the version of Gum you are using with gum --version
• Mask input for passwords with gum input --password.
• Set the gum confirm default to the negative action with gum confirm --default=false
• gum spin --show-output to display output after spinning (as well as exit codes will match the command that was run)
• gum filter now aborts action when ctrl+c is pressed and exits with status 130.

New Contributors

• @muesli made their first contribution in #44
• @wissam made their first contribution in #24

Full Changelog: v0.1.0...v0.2.0

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Slack.

v0.1.0

Introducing Gum!

A tool for glamorous shell scripts! Gum provides a collection of many highly configurable, ready-to-use utilities to help you write useful shell scripts and aliases with just a few lines of code.

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Slack.