Images of shells by the sea

Gum – interactive components for shell scripts

Gum provides a collection of interactive terminal components that can be used directly from shell scripts. It makes it possible to ask users to select an option, confirm an action, enter text or choose a file without having to implement a text-based interface from scratch. Each component is available through a command that can be combined with other shell operations.

The program is useful for scripts that need input from the person running them. A script can present a menu of available actions, store the selected value in a variable and use that value in subsequent commands. Gum also provides components for displaying formatted text, progress indicators and tabular information, making it possible to create more structured terminal workflows. The appearance and behaviour of these components can be adjusted through command-line options and environment variables.

This is free and open source software.

Key Features

  • Choose – display an interactive menu for selecting one or multiple items from a list.
  • Filter – narrow candidate lists using fuzzy matching, with support for multiple selections.
  • Confirm – request confirmation before continuing, using the command’s exit status to indicate the response.
  • File – navigate a directory tree and select a file.
  • Input – request single-line text input, including password entry.
  • Write – collect multiline text through an interactive editor.
  • Table – display tabular data and allow the user to select a row.
  • Pager – browse text with configurable display styling and line numbers.
  • Spin – display an animated progress indicator while another command executes.
  • Style – apply colours, borders, spacing and alignment to terminal text.
  • Format – render Markdown, syntax-highlighted code, templates and named emoji.
  • Join – combine formatted text horizontally or vertically.
  • Log – display structured log messages with configurable levels and styling.
  • Cross-platform support – runs on Linux, macOS, and Windows.

Website: github.com/charmbracelet/gum
Support:
Developer: Charmbracelet, Inc
License: MIT License

Commands available with gum

Gum is written in Go. Learn Go with our recommended free books and free tutorials.


Explore Linux

Best Free and Open Source Software - A huge collection of recommended free and open source software covering every major category.
In-depth Linux Software Reviews - Detailed assessments of Linux software covering features, usability and overall quality.

The Big List of Active Linux Distros - An extensive collection of actively developed Linux distributions.
Open Source Alternatives - Alternatives to software and services from Google, Microsoft, Apple, Adobe, IBM, Autodesk, Oracle and others.
Essential Linux System Tools - Indispensable utilities for monitoring, maintaining and managing Linux systems.
Linux Productivity Tools - Useful utilities for improving productivity and streamlining everyday tasks.
Alternatives to Popular CLI Tools - Modern alternatives to familiar command-line utilities supplied with Linux systems.
Awesome Free Linux Game Tools - Tools, utilities and companion software that improve gaming on Linux.
Machine Learning on Linux - Machine learning and deep learning software, self-hosted applications and practical tools.
Saving Money with Linux - Practical ways to reduce electricity consumption and lower computing costs with Linux.
Linux Candy - Fun, entertaining and sometimes delightfully quirky software from the lighter side of Linux.
Subscribe

Please read our Comment Policy before commenting.

Notify of
guest
0 Comments
Oldest
Newest Most Voted