TUI login wizard

Full-screen terminal UI login screen. Used when entering the interactive REPL and credentials are not explicit. Tab moves focus; Enter submits; Esc cancels.

Description

## Overview The TUI login wizard is the full-screen terminal UI credential collector used when `delta-forge-cli` enters its interactive REPL. It renders URL, Username, and Password fields in a framed dialog and submits the values to the login handshake. ## Behavior - Triggered at REPL launch when `credentials_explicit` is false and stdin reports a TTY. The implementation is `tui::collect_credentials_tui`. - Field order is URL, Username, Password. Tab moves focus forward, Shift+Tab moves focus backward, Enter submits the form, and Esc cancels and exits the CLI with a non-zero status. - Values entered in the wizard overwrite the corresponding fields on `CliConfig` before `authenticate` is called. A cancel (Esc) exits without attempting login. - The wizard does not persist values to disk. Each REPL launch opens a fresh wizard unless credentials were already supplied via flag, environment, or profile. ## Compatibility - Requires a terminal that supports raw mode and ANSI escape sequences. Works in most modern terminals, including Windows Terminal and WSL.

Examples

delta-forge-cli  # opens TUI login

Pitfalls

• The wizard requires a genuinely interactive TTY. CI containers that allocate a PTY but have no human at the keyboard cause the wizard to hang waiting for input; supply `--username` and `--password` (or the `DF_USERNAME` / `DF_PASSWORD` env vars) for non-interactive runs.
• Esc exits the entire CLI with a non-zero status. If you meant to clear a field and retry, use Backspace within the field rather than Esc.
• Entered credentials live only in the current REPL process. They are not written to the profile store, so closing and reopening the REPL prompts again.

See Also

• CLI_AUTH_PROMPT_INLINE