Pad Everything

This is a small feature release that adds --padding to as many commands as possible. For example:

Padding arguments work similarly to CSS values:

• With one value, padding applies to all sides (--padding="4")
• With two values, padding applies vertically and horizontally, respectively (--padding="4 10")
• With four values, padding applies top, right, bottom, and left, respectively (--padding="4 10")

Which commands can be padded? These:

• choose
• confirm
• file
• filter
• input
• pager
• spin
• style
• table
• write

Special thanks to @caarlos0 for banging this one out in record time, for none other than @dhh. 💎

Changelog

New Features

• 6045525: feat: adding --padding to most commands (#960) (@caarlos0)

Other work

• 09940da: ci: sync dependabot config (#956) (@charmcli)
• 8c12c2a: ci: sync golangci-lint config (#946) (@github-actions[bot])

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/gum/releases/download/v0.17.0/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/gum/releases/download/v0.17.0/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/gum/releases/download/v0.17.0/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

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

Changelog

Bug fixes

• 501402c: fix(choose): fix typo in environment variable GUM_CCHOOSE_TIMEOUT (#922) (@sadamczyk)
• 0107dff: fix(filter): text input width is too small (#919) (@caarlos0)
• 8081f74: fix: logic to handle interrupt before timeout in error checking (#918) (@arithmeticmean)

Documentation updates

• 3c972b0: docs: add contributing guidelines (#920) (@bashbunni)

Other work

• f1e274c: ci: sync golangci-lint config (#911) (@github-actions[bot])

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/gum/releases/download/v0.16.2/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/gum/releases/download/v0.16.2/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/gum/releases/download/v0.16.2/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

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

Changelog

Bug fixes

• e292bbf: fix: detect timeout error and apply default option (#888) (@mikybars)
• 817c4bd: fix: lint issues (#909) (@caarlos0)
• 4fea9a0: fix: make empty line before help consistent (@caarlos0)

Documentation updates

• 39290a0: docs: use $EDITOR instead of EDITOR (#897) (@haya14busa)

Other work

• 6682e20: ci: sync dependabot config (#896) (@charmcli)
• a539127: ci: update lint jobs and settings (@caarlos0)

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/gum/releases/download/v0.16.1/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/gum/releases/download/v0.16.1/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/gum/releases/download/v0.16.1/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

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

Hey, little counter

This release contains some bug fixes as well as a small feature that adds an item position counter to the help. It's right there on the bottom left!

Changelog

New Features

• 984c84f: feat(table): show indicator on help keybindings (opt-in) (#839) (@raphamorim)

Bug fixes

• 204d219: fix(choose): order when using --label-delimiter (#867) (@caarlos0)
• 2b72e80: fix(confirm): ensure --show-output show the right answer (#853) (@andreynering)
• 93f6857: fix(spin): preserve color output when --show-output is given (#850) (@andreynering)
• d795b8a: fix(table): padding on item indicator (#841) (@caarlos0)
• 9705aa3: fix: generated completion invalid for fish shell (#837) (@raphamorim)
• bb098b2: fix(choose): generated completion invalid for fish shell (choose/options) (#838) (@raphamorim)
• 85a2980: fix(filter): wildcard escaping issue (#862) (@abelcha)

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/gum/releases/download/v0.16.0/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/gum/releases/download/v0.16.0/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/gum/releases/download/v0.16.0/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

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

Changelog

Bug fixes

• d1fc051: fix(pager): memory/cpu usage when using soft-wrap (#827) (@caarlos0)

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/gum/releases/download/v0.15.2/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/gum/releases/download/v0.15.2/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/gum/releases/download/v0.15.2/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

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

This is a small release fixing some bugs introduced in v0.15.0.

Changelog

Bug fixes

• 2846d19: Revert "feat(table): set --print if stdout is not a terminal (#762)" (#811) (@caarlos0)
• 30bc180: fix(confirm): do not print 'not confirmed' on exit 1 (#814) (@caarlos0)
• 3745655: fix(filter): wrong highlight when option has grapheme clusters (#799) (@caarlos0)
• 2da9527: fix(spin): clear title after finished (#815) (@caarlos0)
• 7e3216e: fix(viewport): remove extra line in viewport help (#816) (@caarlos0)
• c11af42: fix(write): ctrl+j not making new line (#819) (@caarlos0)
• 05c4bb9: fix: spin when not a tty (#813) (@caarlos0)

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/gum/releases/download/v0.15.1/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/gum/releases/download/v0.15.1/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/gum/releases/download/v0.15.1/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

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

No longer a sticky situation

This release contains a small boatload of fixes and quality-of-life features across the board by the great @caarlos0 and some awesome contributors.

Most importantly we detangled Gum and Huh. The two libraries were too tightly coupled creating a difficult environment to maintain. With this separation, Gum much easier to maintain, especially for contributors. Chew on that!

General Stuff

No more weird ANSI: gum now strips ANSI sequences by default. Want ‘em back? just add --no-strip-ansi.

We fixed some bugs with existing timeouts + they can now be used in confirm, choose, file, filter, input, pager, and spin. You can specify the units, i.e. --timeout=750ms, --timeout=1m30s

Choose

Sometimes you want the user-facing choice to be different than the outputted value. Now you can do that with --label-delimiter:

$ printf 'Pocky:0\nRamen:1\nShrimp Chips:2\n' | gum choose --label-delimiter=':'

Want to select all options by default? Use --select='*'.

$ printf 'Pocky\nRamen\nShrimp Chips\n' | gum choose  --select='*'

Confirm

No you can print the chosen value with --show-output:

$ gum confirm --show-output 'Do you agree?'
Do you agree? No
exit status 1

File

You can now add a header to your filepickers with the --header set of flags.

gum file --header="Whatcha gonna pick?"

For details see gum file --help.

Filter

Better delimiters, select all, and so on

Press ctrl+a to select all choices, esc to unfocus the filter field.

Want some defaults? Use --selected to preselect choices. You can also use --input-delimiter and --output-delimiter for more flexibility around input and output.

$ echo "JS|Android|iOS" | gum filter --selected='*' --input-delimiter="|" --no-limit --output-delimiter=","

Freeform input

Filter's --no-strict allows you to create a new option if no matches are found; it's essentially a free input field. Go crazy!

Sort: we fixed it

Filter's --sort would sort by score which was causing some confusion for users. To clarify this behaviour, --sort is deprecated in favour of --[no]-fuzzy-sort.

Want to sort alphabetically? Leverage the sort command in a pipeline:

$ cat input.txt | sort | gum filter --no-sort

Log

Now you can set a minimum log level with GUM_LOG_LEVEL. Valid values are debug, info, warn, error, and fatal.

Spin

You can now use --show-stdout and --show-stderr to print output:

$ gum spin --show-stdout --title "Running command..." -- sleep 10 && echo hello

Table

We expanded the table API to allow users to control more fields in csv.Reader through gum. This includes --lazy-quotes and --fields-per-record. This should fix issues with gum struggling to read CSV files properly. For details see gum table --help.

We also made a bunch of rendering improvements such as growing the table rows based on --columns, settings sane defaults widths, ignoring BOMs (byte order marks), and so on.

Changelog

New!

• feat(choose): --selected="*" to select all by @caarlos0 in #769
• feat(choose,filter): --input-delimiter --output-delimiter by @caarlos0 in #779
• feat(confirm): add --show-output by @vahnrr in #427
• feat(file): add --header by @caarlos0 in #768
• feat(file): show permissions and size by @caarlos0 in #717
• feat(filter): --select-if-one returns if single match by @caarlos0 in #778
• feat(filter): allow to focus out of filter by @caarlos0 in #776
• feat(filter): allow to pre-select items with --selected by @caarlos0 in #777
• feat(filter): ctrl+a to toggle select all by @caarlos0 in #770
• feat(log): support setting minimum log level with GUM_LOG_LEVEL by @caarlos0 in #723
• feat(spin): --show-stdout --show-stderr by @caarlos0 in #774
• feat(style): trim line spaces by @caarlos0 in #767
• feat(table): --lazy-quotes and --fields-per-record by @caarlos0 in #759
• feat(table): add help by @caarlos0 in #756
• feat(table): set --print if stdout is not a terminal by @caarlos0 in #762
• feat(version): adds command to check current gum version by @caarlos0 in #775
• feat: adding return column to table command by @deicon in #415
• feat: allow cursor option in file by @radar07 in #667
• feat: esc exit 1, ctrl+c exit 130, help arrow order by @caarlos0 in #771
• feat: handle focus/blur events by @caarlos0 in #749
• feat: improve handling ctrl+c and timeouts by @caarlos0 in #747

Fixed

• fix(choose): --ordered by @caarlos0 in #722
• fix(choose,confirm,file,filter,input,pager,spin): timeout default unit by @caarlos0 in #724
• fix(confirm) --timeout was ignored, now works as documented by @dpritchett in #697
• fix(confirm,choose,file,input): timeout handling by @caarlos0 in #718
• fix(filter): --no-strict not working, also weird behavior by @caarlos0 in #737
• fix(filter): abort on ctrl+q by @caarlos0 in #721
• fix(pager): do not strip ansi sequences by @caarlos0 in #754
• fix(pager): use help bubble by @caarlos0 in #748
• fix(spin): if not a tty, only print title, do not open tty for stdin by @caarlos0 in #763
• fix(spin): indenting lines when command is piped by @aymanbagabas in #636
• fix(spin): interrupt child process on ctrl+c by @caarlos0 in #732
• fix(stdin): trim space instead of \n by @caarlos0 in #761
• fix(table): grow table rows based on --columns by @caarlos0 in #760
• fix(table): ignore BOM by @caarlos0 in #757
• fix(table): only set height if > 0 by @caarlos0 in #716
• fix(table): set widths by @caarlos0 in #758
• fix(write): max height, max chars by @caarlos0 in #753
• fix: clarify filter --sort flag by @caarlos0 in #738
• fix: strip ansi sequences from stdin by @caarlos0 in #739
• fix: quote tmux session name in code sample by @oalders in #745

Other Stuff

• refactor: removing huh as a dep by @caarlos0 in #742
• chore(nix): update src hash by @ctn-malone in #733

New Contributors

• @dpritchett made their first contribution in #697
• @radar07 made their first contribution in #667
• @ctn-malone made their first contribution in #733
• @oalders made their first contribution in #745

Full Changelog: v0.14.5...v0.15.0

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/gum/releases/download/v0.15.0/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/gum/releases/download/v0.15.0/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/gum/releases/download/v0.15.0/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

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