macOS
brew install gumlocal Homebrew formula metadata
sudo port install gumMacPorts ports tree · devel/gum/Portfile · source: api.github.com
brew
Tool for glamorous shell scripts. Version 0.17.0 via Homebrew; verified from local package data.
install
brew install gumlocal Homebrew formula metadata
sudo port install gumMacPorts ports tree · devel/gum/Portfile · source: api.github.com
sudo apk add gumAlpine Linux edge package indexes · gum · source: dl-cdn.alpinelinux.org
sudo apt install gumDebian stable package indexes · gum · source: deb.debian.org
sudo dnf install gumFedora Rawhide package metadata · gum · source: dl.fedoraproject.org
nix profile install nixpkgs#gumnixpkgs package indexes · pkgs/by-name/gu/gum/package.nix · source: api.github.com
sudo pacman -S gumArch Linux sync databases · gum · source: geo.mirror.pkgbuild.com
sudo zypper install gumopenSUSE Tumbleweed package metadata · gum · source: download.opensuse.org
scoop install main/gumScoop official bucket manifest trees · bucket/gum.json · source: api.github.com
winget install --id charmbracelet.gum -eWindows Package Manager source index · charmbracelet.gum · source: cdn.winget.microsoft.com
overview
Tool for glamorous shell scripts
history
Gum is Charmbracelet's command-line toolkit for adding prompts, pickers, spinners, styled output, and other terminal UI pieces to shell scripts without writing a full Go TUI application.
The GitHub repository was created in June 2022 and the v0.1.0 release was published in July 2022. Gum builds on Charmbracelet's Go terminal UI libraries, especially Bubble Tea-related components, Bubbles, and Lip Gloss, but exposes them as composable shell commands.
The project fits Charmbracelet's broader line of polished terminal tools by turning reusable TUI primitives into Unix-style commands such as `choose`, `input`, `confirm`, `filter`, `spin`, `style`, `table`, and `write`.
The README documents installs through Homebrew, Arch, Fedora, Nix, Flox, WinGet, Scoop, Debian/Ubuntu, RPM repositories, FreeBSD packages, release archives, and `go install`, which shows that the tool crossed from Go developer circles into general shell-scripting package sets.
Because each command writes ordinary stdout/stderr and composes with variables, files, and pipes, Gum was adopted as a small dependency for dotfiles, setup scripts, demos, and internal operations scripts that need friendlier prompts.
Gum commands are used directly in shell scripts: `gum choose` selects from choices, `gum input` reads text, `gum confirm` gates an action, `gum filter` narrows lists, and `gum style` formats terminal output. The official tutorial uses a Conventional Commits helper as a representative script.
Customization is mostly through command flags and environment variables, keeping the package useful in one-off scripts and shared dotfiles without a separate application framework.
Gum is interesting to package maintainers because it packages a Go TUI ecosystem as a single static-ish command suite with broad OS coverage. It also illustrates a modern pattern where a developer-friendly CLI becomes both an end-user utility and a building block for other scripts.
For shell users, it replaces many ad hoc `read`, `select`, `fzf`, spinner, and ANSI-formatting snippets with one package whose behavior can be versioned by the system package manager.
security posture
generalized runtime or code generation signal.
yellow risk · medium confidence · runtime
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
gum | cli | global executable |
freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
https://github.com/charmbracelet/gum
install metadata
| Package key | brew:gum |
|---|---|
| Version | 0.17.0 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/gum |
| Homepage | https://github.com/charmbracelet/gum |
| Repository | https://github.com/charmbracelet/gum |
| Upstream docs | https://github.com/charmbracelet/gum#readme |
| License | MIT |
| Source archive | https://github.com/charmbracelet/gum/archive/refs/tags/v0.17.0.tar.gz |
| Build dependencies | go |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | gum |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
gum 0.14.4-1+b6
Tool for glamorous shell scripts 🎀
https://github.com/charmbracelet/gum
sudo apt install gumgum
nix profile install nixpkgs#gumgum 0.16.2-r10
Highly configurable utilities for writing interactive shell scripts
https://github.com/charmbracelet/gum
sudo apk add gumgum-bash-completion 0.16.2-r10
Bash completions for gum
https://github.com/charmbracelet/gum
sudo apk add gum-bash-completiongum-doc 0.16.2-r10
Highly configurable utilities for writing interactive shell scripts (documentation)
https://github.com/charmbracelet/gum
sudo apk add gum-docgum-fish-completion 0.16.2-r10
Fish completions for gum
https://github.com/charmbracelet/gum
sudo apk add gum-fish-completiongum-zsh-completion 0.16.2-r10
Zsh completions for gum
https://github.com/charmbracelet/gum
sudo apk add gum-zsh-completiongum 0.17.0-3.fc45
Tool for glamorous shell scripts
https://github.com/charmbracelet/gum
sudo dnf install gumgum 0.17.0-1
A tool for glamorous shell scripts
https://github.com/charmbracelet/gum
sudo pacman -S gumgum 0.16.0-1.4
Tool for glamorous shell scripts
https://github.com/charmbracelet/gum
sudo zypper install gumgum-bash-completion 0.16.0-1.4
Bash Completion for gum
https://github.com/charmbracelet/gum
sudo zypper install gum-bash-completiongum-fish-completion 0.16.0-1.4
Fish Completion for gum
https://github.com/charmbracelet/gum
sudo zypper install gum-fish-completiongum-zsh-completion 0.16.0-1.4
Zsh Completion for gum
https://github.com/charmbracelet/gum
sudo zypper install gum-zsh-completiongum
sudo port install gummain/gum
scoop install main/gumcharmbracelet.gum
winget install --id charmbracelet.gum -esource trail
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
View the package source record on GitHub.