Professional Command-Line Apps and Terminal UIs with Cobra, Bubble Tea, and Lip Gloss

Read before you buy: the PDF here is a free sample — the first 20 pages of the 515-page book (payments, sales and reviews on this demo site are sample data). Get the full e-book at thenexbooks on Gumroad.

Build Go command-line tools that people enjoy using, trust in scripts, and install with one command.

Developers notice immediately when a command-line tool feels wrong: flags that mean different things in different commands, error messages that explain nothing, colors that end up in log files, tables that break when piped, progress bars that never clean up. Go is a superb language for CLI and TUI tools — one static binary, instant startup, easy cross-compiling — but knowing the libraries is not the same as building a tool that feels right.

This book takes one realistic tool from a first prototype with the standard flag package to a polished, tested, released, self-updating application with an interactive dashboard and a plugin system. Every convention is explained, not just applied, so you can make good decisions in your own tools.

What's inside

• What users expect from a CLI: stdout versus stderr, exit codes, help text, quiet success, and composable output
• Designing commands, arguments, and flags, and a first prototype with os.Args and the flag package
• Cobra in depth: command trees, persistent flags, argument validation, hooks, groups, and testable project structure
• Layered configuration with TOML files, environment variables, and flags, with precedence users can inspect
• Output for humans and machines: aligned tables, stable JSON contracts, and CSV
• Errors that users can act on, and exit codes that scripts can rely on
• stdin, pipes, imports, and prompts that never hang in CI
• Ctrl+C, SIGTERM, timeouts, and graceful shutdown with context
• Color and style with Lip Gloss v2, NO_COLOR, TTY detection, and accessibility; progress bars and spinners; logging with log/slog
• Cross-platform files and paths, atomic writes, locks, and the Windows details that bite
• Shell completion for bash, zsh, fish, and PowerShell, help topics, and man pages
• Interactive TUIs with Bubble Tea v2 and Bubbles: the Elm architecture, layout, tables, lists, inputs, live timers, external editors, and forms
• Testing CLIs and TUIs: in-process command tests, golden files, testscript end-to-end scripts, update tests, frame snapshots, and teatest
• Quality gates: cross-platform CI, the race detector, fuzzing, and linters
• Versioning, ldflags, build info, and cross-compiling for Linux, macOS, and Windows
• Releasing with GoReleaser, with Homebrew, Scoop, and winget manifests; self-update with checksum verification; and exec-based plugins

One running example, start to finish. You build stint, the time tracker of Ninebark Studio, a fictional product studio. Developers start and stop timers and pipe JSON into other tools, the studio lead wants billable reports and CSV for the accountant, designers want a full-screen dashboard with a live timer, and a contractor on Windows finds every portability bug. stint is small enough to understand completely, yet it needs everything a real tool needs — and its sample data is fixed, so every number in a report can be checked by hand.

Current and honest. The code targets Go 1.26 and later, was tested with Go 1.27, and uses Cobra 1.10 and the v2 generation of Bubble Tea, Bubbles, and Lip Gloss, with the differences from older v1 tutorials pointed out where they matter. Commands, outputs, and test results come from real runs. Steps that cannot run on a single development machine, such as a GoReleaser publication or a package-manager installation, are clearly marked and shown as output "similar to" what you will see. There are no invented benchmarks or statistics. Every chapter includes complete code, Tips, Notes, Warnings, Try It Yourself exercises, and Key Takeaways, and the appendices give you a cheat sheet, copy-ready templates, a production checklist, and a glossary.

Format: PDF, 515 pages (A4), linked table of contents and bookmarks. English. First Edition, 2026. Published by thenexbooks. Includes the stint starter project (Go module) that the book builds on. Requires working knowledge of Go. This book is independent and is not affiliated with, sponsored by, or endorsed by Google LLC, Charmbracelet, Inc., or the maintainers of the projects it covers.

Table of Contents

Part I — Foundations of a Professional CLI

• Ch 1 · What Makes a Great Command-Line Tool: Conventions, Expectations, and Meet stint
• Ch 2 · From os.Args to the flag Package: A First Prototype
• Ch 3 · Designing Commands, Arguments, and Flags: Names, Defaults, and Help Text
• Ch 4 · Cobra Fundamentals: Commands, Flags, Argument Validation, and the Command Tree
• Ch 5 · Structuring a CLI Project: Packages, the App Struct, and a Testable main

Part II — Input, Output, and Behavior

• Ch 6 · Configuration: Files, Environment Variables, Flags, and Precedence
• Ch 7 · Output for Humans and Machines: Tables, JSON, and CSV
• Ch 8 · Errors, Exit Codes, and Messages Users Can Act On
• Ch 9 · stdin, stdout, and Pipes: Filters, Imports, and Safe Prompts
• Ch 10 · Signals, Context, and Cancellation: Ctrl+C, Timeouts, and Graceful Shutdown

Part III — Terminal Craft

• Ch 11 · Color and Style with Lip Gloss: NO_COLOR, TTY Detection, and Accessibility
• Ch 12 · Progress Bars, Spinners, and Status Lines for Long-Running Work
• Ch 13 · Logging and Diagnostics: log/slog, --verbose, and Bug Reports
• Ch 14 · Files, Paths, and Cross-Platform Behavior: Config Directories, Atomic Writes, Locks, and Windows
• Ch 15 · Shell Completion, Help Topics, and Man Pages

Part IV — Interactive TUIs with Bubble Tea

• Ch 16 · The Elm Architecture in Bubble Tea v2: Model, Update, View, and Commands
• Ch 17 · Layout and Styling for TUIs with Lip Gloss: Boxes, Joins, Widths, and Resizing
• Ch 18 · Bubbles Components: Tables, Lists, Text Inputs, Spinners, Progress Bars, and Help
• Ch 19 · Building the stint Dashboard: Screens, Focus, Key Maps, and a Live Timer
• Ch 20 · Async Work in TUIs: Commands, Ticks, External Editors, and Forms

Part V — Testing CLIs and TUIs

• Ch 21 · Testing Commands In-Process: Fake Clocks, Fake Environments, and Captured Output
• Ch 22 · Golden Files and End-to-End Tests with testscript
• Ch 23 · Testing Bubble Tea Programs: Update Tests, Frame Snapshots, and teatest
• Ch 24 · Quality Gates: Cross-Platform CI, the Race Detector, Fuzzing, and Linters

Part VI — Shipping and Extending

• Ch 25 · Versioning and Cross-Compiling: ldflags, Build Info, GOOS/GOARCH, and Reproducible Builds
• Ch 26 · Releasing with GoReleaser: Archives, Checksums, Homebrew, Scoop, and winget
• Ch 27 · Self-Update and Update Notices: Release Manifests, Checksums, and Replacing a Running Binary
• Ch 28 · Plugins and Extensibility, and a Production Checklist for CLI Tools

Appendices
A · CLI and TUI Cheat Sheet
B · Templates and Reference
C · Production Checklist for CLI and TUI Tools
D · Glossary

Book details