Skip to content

TUI Overview

The TFx TUI is an interactive terminal interface for browsing your HCP Terraform or Terraform Enterprise resources. Instead of running individual CLI commands, you can navigate organizations, projects, workspaces, runs, variables, state, and configuration versions in a single session.

Launching the TUI

Run tfx with no arguments:

Terminal window
tfx

The TUI uses the same configuration as the CLI. If you haven’t configured TFx yet, see Getting Started.

To authenticate for the first time or manage profiles:

Terminal window
tfx login

What you’ll see

When the TUI starts, you land on the Organizations list showing all organizations accessible to your API token. From there, drill into any resource:

Organizations > Projects > Workspaces > Runs / Variables / State / Config

A breadcrumb bar at the top always shows where you are. Press esc to go back, enter to drill in.

Quick reference

KeyAction
enterSelect / drill in
escGo back
/Filter the current list
?Show keyboard shortcuts
qQuit

See Navigation for the full keyboard reference and Features for details on the API inspector, state viewer, and more.