Environment resolution

Deploy and export scripts need three machine-specific values: TC_ROOT, TC_DATA, and UPG. tcli resolves each, in order, from:

1. the per-machine tcli env file, .tcli.env.yaml;
2. the matching environment variable (TC_ROOT, TC_DATA, UPG);
3. (TUI only) an interactive prompt that persists your answer to the per-machine tcli env file.

In the TUI

The Home screen surfaces the resolved values and their source. Its edit action writes them to .tcli.env.yaml.

In headless mode

Headless commands never prompt. An unresolved value is a hard error that names both the tcli env file and the environment variable to set.

.tcli.env.yaml

This file holds per-machine values and must never be committed. It is specific to each developer’s or agent’s machine. Add it to your project’s .gitignore.

The value-to-environment-variable mapping is documented in Environment variables. See the .tcli.env.yaml schema for the full file format.