Terminal User Interfaces (TUIs): GUIs for the Console

Why it exists

Simple command-line interfaces (CLIs) are powerful for scripting but clumsy for tasks requiring constant visual context, like monitoring a server or navigating a complex directory. TUIs were created to provide a richer, interactive experience directly in the terminal, blending the speed and low resource usage of the console with the usability of a graphical interface.

The mental model

Think of a TUI as a GUI for your terminal. It's an application that takes over the terminal screen, drawing its own interface using text characters, colors, and block elements. Unlike a desktop app, it needs no separate window manager or graphics server. It's a self-contained, stateful application living entirely within your terminal session.

How it works

TUIs are built with libraries (like Bubble Tea in Go or tui-rs in Rust) that abstract away raw terminal control codes. These libraries let developers position the cursor, set colors, draw boxes, and listen for keyboard or mouse events. The application runs in a continuous loop, redrawing the screen in response to user input or background data changes, creating the illusion of a dynamic interface.

When to use it

Use a TUI for tools that benefit from a persistent visual context and keyboard-centric navigation, especially over SSH. They are ideal for system resource monitors (btop), interactive database clients, Git clients (lazygit), and container management dashboards (k9s). They are fast, lightweight, and work well in low-bandwidth environments.

When not to use it

Avoid TUIs for tasks that are easily scriptable or fit into a standard Unix pipeline (like grep or sed). If your application needs complex graphics, rich media, or is intended for non-technical users who are unfamiliar with terminals, a native GUI or web interface is a much better choice.

One canonical example

btop++ is a modern resource monitor that perfectly exemplifies a TUI. It displays CPU, memory, disk, and network usage in real-time using graphs, meters, and sortable process lists. It is fully interactive, supporting keyboard and mouse input to change views, filter processes, and send signals, providing an experience comparable to a graphical activity monitor.