# charmbracelet/gum

A tool for glamorous shell scripts 🎀

Repository: https://github.com/charmbracelet/gum
Canonical: https://ross.abutalabs.com/products/gum
Language: Go
License: MIT
License Family: permissive
Topics: bash, shell
Last push: 2026-08-20T08:08:40+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 86, longevity 100
- inputs: {"age_days": 1545, "days_push": 13, "days_rel": 13, "gap_med": 57.5, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 24285, forks 542 (observed 2026-08-28T04:11:35.816710+00:00)

## What it is
Gum is a command-line tool that adds polished interactive UI components—menus, text inputs, confirmations, spinners, and more—to shell scripts without writing any Go code. It is built on the Charm Bubble Tea ecosystem and works in bash, zsh, fish, and other shells.

## Use cases
- add interactive prompts to bash scripts
- build a conventional commit helper script
- ask users to choose from a menu in a shell script
- create styled confirmation dialogs in dotfile aliases
- add spinners and progress feedback to shell automation
- collect multi-line text input from the terminal

## When to choose
- you write shell scripts and want polished interactive UI without learning a TUI framework
- you want a single static binary that works across bash, zsh, and fish
- you are building dotfile aliases or CLI helpers with prompts and confirmations

## When to avoid
- you need a full TUI application with complex layouts—use Bubble Tea directly
- your project is in Go and you can import the underlying libraries instead of shelling out
- you need GUI or web-based interfaces rather than terminal interaction

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, terminal-ui, developer-tools
- domain: developer-tools
- platform: windows, cli, cross-platform
- tags: shell-scripts, interactive-prompts, tui, bash, dotfiles, charmbracelet, command-line, automation, linux, macos

## Member repositories
- charmbracelet/gum (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:35.816710+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:56:15.884554+00:00, confidence not recorded.
  - readme: https://github.com/charmbracelet/gum (fetched 2026-08-28T04:11:35.816710+00:00, sha 1a2cbdb29918)
- Data as of 2026-08-30T08:39:29.467469+00:00.