v0.14.5

This is a small maintenance release to bump dependencies, update linter config, and adjust GoReleaser configuration.

Changelog

Bug fixes

• b9611e1: fix: lint issues (#663) (@caarlos0)

Dependency updates

• 6837ed2: feat(deps): bump github.com/charmbracelet/bubbletea from 0.27.0 to 1.0.0 (#661) (@dependabot[bot])
• 8ab6253: feat(deps): bump github.com/charmbracelet/bubbletea from 1.0.0 to 1.1.0 (#665) (@dependabot[bot])
• 65e46d6: feat(deps): bump github.com/charmbracelet/x/ansi from 0.2.2 to 0.2.3 (#656) (@dependabot[bot])

Other work

• a30dda5: build: fix goreleaser version (@caarlos0)
• 1917023: ci: fix dependabot config (@caarlos0)

---

Verifying the artifacts

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

wget 'https://github.com/charmbracelet/gum/releases/download/v0.14.5/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.14.5/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/gum/releases/download/v0.14.5/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.

v0.14.4

Au revoir, bugs

This release fixes a buncha bugs and introduces a nice lil' quality-of-life feature.

Changelog

New!

• 8422c49: feat(filter): Add cyclic navigation (#483) (@piero-vic)

Fixed

• e095a91: fix(input): wrong height when using borders in the header (@caarlos0)
• d722a2f: fix: height 0 by default (#640) (@caarlos0)
• 046a4d3: fix: use 0 as default width (#634) (@caarlos0)
• 9db5c7f: fix: select all keybindings (#639) (@caarlos0)
• 96448e0: fix: show background style help (#641) (@caarlos0)

Deps

• dd5aa97: feat(deps): bump github.com/charmbracelet/bubbles (#654) (@dependabot[bot])
• 1a91d33: feat(deps): bump github.com/charmbracelet/glamour from 0.7.0 to 0.8.0 (#646) (@dependabot[bot])
• 2ee90c8: feat(deps): bump github.com/charmbracelet/lipgloss (#655) (@dependabot[bot])
• f55c314: fix(deps): update huh (@caarlos0)

Docs

• 7e56d57: docs: update install instructions (@caarlos0)

Other stuff

• 19a93b0: refactor(input): simplify echoMode (@caarlos0)

---

Verifying the artifacts

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

wget 'https://github.com/charmbracelet/gum/releases/download/v0.14.4/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.14.4/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/gum/releases/download/v0.14.4/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.

v0.14.3

Fixin’ more bugs

Hot on the heels of the last release (very hot, in fact), here’s one more quick point release to fix a regression in spinner.

---

Verifying the artifacts

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

wget 'https://github.com/charmbracelet/gum/releases/download/v0.14.3/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.14.3/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/gum/releases/download/v0.14.3/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.

v0.14.2

Fixin’ bugs

This is a maintenance release to pull in various fixes from huh upstream. As a bonus, macOS binaries are now also signed and notarized courtesy @goreleaser.

Thanks for using Gum!

Changelog

New

• sign and notarize macos binaries in #612

Changed

• use in-house utility packages in #616

Fixed

• drop left padding in choose in #597
• fix race conditon where spinner could mis-render in #621
• fix a bug where choose could crash when spacebar is pressed twice #587
• fix a bug where the foreground color could not be set in choose #614
• fix a bug where foreground could not be set in write #583
• fix a bug where keypresses could crash choose #580
• restore y/n keybindings to confirm #568
• restore centering to buttons in confirm #566

New Contributors

• @csandeep made their first contribution in #618
• @clysto made their first contribution in #598

Full Changelog: v0.14.1...v0.14.2

---

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

v0.14.1

What's Changed

• Show help with Huh? by @maaslalani in #587
• Support using the Home/End keys in pager by @lzm0 in #548

Fixes

• Handle huh? user aborted error by @MikaelFangel in #578
• Cursor styling by @MikaelFangel in #592
• Re-introduce ESC for gum write by @MikaelFangel in #579

New Contributors

• @CodeZea1ot made their first contribution in #542
• @camcui made their first contribution in #537
• @lzm0 made their first contribution in #548

Full Changelog: v0.14.0...v0.14.1

---

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

v0.14.0

Gum + Huh?

Gum v0.14.0 is a major internal refactor which uses huh? internally for choose, confirm, file, input, write inputs!

All functionality remains the same, but you will notice some minor visual changes / improvements.

If you haven't already, check it out:

• https://github.com/charmbracelet/huh

---

Changes

• Use Huh for Gum Choose by @maaslalani in #521
• Use Huh for Gum Confirm by @maaslalani in #522
• Use Huh for Gum File by @maaslalani in #523
• Use Huh for Gum Input by @maaslalani in #524
• Use Huh for Gum Write by @maaslalani in #525
• fix(spin): Output Pipes if Timeout Occurs by @hopefulTex in #461
• Document gum log --time by @ernstki in #472
• feat(spin): Add support for --show-error for the spinner. (rebase #440) by @pingiun in #518

New Contributors

• @ernstki made their first contribution in #472
• @pingiun made their first contribution in #518
• @dungle-scrubs made their first contribution in #513

Full Changelog: v0.13.0...v0.14.0

---

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

v0.13.0

Changelog

New Features

Add --select-if-one flag to gum choose and gum filter.

> gum choose --select-if-one "option"
> option

• fb6849c: --select-if-one flag to choose/filter. (#398) (@kennyp)

Bug fixes

• 5c65944: (fix): ShowOutput flag displays in realtime (#405) (@hopefulTex)

---

Verifying the artifacts

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

wget 'https://github.com/charmbracelet/gum/releases/download/v0.13.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.13.0/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/gum/releases/download/v0.13.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.

v0.12.0

Gum Log 🪵

Version 0.12.0 of gum features a brand new log command. Gum log logs messages to the terminal at using different levels and styling using the charmbracelet/log library.

To get started, simply run:

gum log

# Log some debug information.
gum log --structured --level debug "Creating file..." name file.txt
# DEBUG Unable to create file. name=temp.txt

# Log some error.
gum log --structured --level error "Unable to create file." name file.txt
# ERROR Unable to create file. name=temp.txt

See charmbracelet/log for more usage.

What's Changed

• Pretty Table Print by @maaslalani in #436
• Log command by @aymanbagabas in #449
• Avoid reading from stdin if --value is being used by @piero-vic in #448
• Made filter work with lists as choose by @MikaelFangel in #424

New Contributors

• @cglong made their first contribution in #401
• @docwhat made their first contribution in #433
• @piero-vic made their first contribution in #448

Full Changelog: v0.11.0...v0.12.0

---

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

v0.11.0

Pager Search, Timeouts, and Bug fixes

This release of Gum includes several features and bug fixes to make your Gum usage more smooooth! 🧈

What’s Changed

New

• Pager search functionality (by @MikaelFangel) in #321
• Strip ANSI for gum filter and gum choose when output is not a TTY
• Non-positive widths will cause gum write will use the entire terminal width
• GUM_FORMAT_THEME / GUM_FORMAT_LANGUAGE environment variables
• --no-sort flag for gum filter
• Customizable cursor modes
• Customizable cursor line text
• Add --timeout flag to all subcommands (by @deicon)

Fixed

• Respect file path argument in filepicker

Other stuff

• Switch to termenv.EnvColorProfile() by @kennyp in #387

New Contributors

• @hopefulTex made their first contribution in #303
• @vahnrr made their first contribution in #374
• @kennyp made their first contribution in #387

Full Changelog: v0.10.0...v0.11.0

---

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

v0.10.0

Truecolor Support

Gum historically was limited to ANSI256 colors, but no longer is this the case!

With v0.10.0, gum can now display truecolor if your terminal emulator supports it! 🎨

Try it out with gum style:

gum style --padding "3 10" --margin 2 --background "#6a51ff" --foreground "#ff6dff" "The best colors are true"

Windows Support

Windows users rejoice! Gum v0.10.0 solves a variety of issues allowing gum to work on Powershell and Windows. 🪟

Don't believe us? Take a look for yourself:

Context Headers

With Gum v0.10.0, you can add context with --header flags in gum choose and gum filter. To get started:

gum choose --header "Pick your starter Pokémon" "Bulbasaur" "Charmander" "Squirtle"

New Features

• Keep order of selected items in gum choose with the --ordered flag.
• Use page up / down key bindings in gum file
• gum choose and gum filter can select using ctrl+space
• --header flags for gum choose and gum filter
• Pass programming language for gum format --type code

---

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