tz

tz is a terminal-based time zone helper that displays current time across multiple time zones in an interactive TUI interface. When run without arguments, it shows local time and UTC, but becomes more useful when configured with specific time zones from the standard tz database.

The tool supports three configuration methods with a clear precedence order: configuration file (~/.config/tz/conf.toml), environment variable (TZ_LIST with semicolon-separated zone names), and command line arguments. Time zones can be aliased with custom names for easier identification, such as "EMEA office" for Europe/Paris. The interface automatically adapts to light and dark terminal themes.

This tool is particularly useful for developers, remote workers, and anyone who regularly coordinates across time zones. It eliminates the need for manual time zone calculations or web-based converters by providing a persistent, customizable display. The TUI format makes it suitable for keeping open in a terminal session while working on scheduling or coordination tasks.

Installation

# via Homebrew
brew install tz

# via Go
go install github.com/oz/tz@latest