Environment variables

Usually the only variable you set is EASYTRACE_TOKEN, and only in CI. Everything else is detected.

Variable	Default	When to set it
EASYTRACE_TOKEN	—	In CI: the project token (et_proj_…). Wins over a stored easytrace login.
EASYTRACE_API_URL	apiUrl in the config, then https://api.easytrace.dev	Another EasyTrace instance, for this shell only
EASYTRACE_SUITE	default	Suite name for upload <files> / coverage without --suite
EASYTRACE_BUILD_ID	Detected on CI; one per invocation locally	A CI that isn't detected, or to merge shards from different machines
EASYTRACE_BRANCH	Detected on CI; git branch --show-current locally	Keep a local run out of the default-branch baseline (e.g. local/<you>)
EASYTRACE_COMMIT_SHA	Detected on CI; git rev-parse HEAD locally	A CI that checks out a merge commit
EASYTRACE_COMMIT_MESSAGE	git log -1 --format=%s	Rarely
EASYTRACE_PR_NUMBER	Detected on CI	A CI that isn't detected
EASYTRACE_BUILD_URL	Detected on CI	A CI that isn't detected — the run links back to it
EASYTRACE_FLUSH_TIMEOUT	60 (seconds)	Large artifact uploads; what is left after the timeout is skipped with a warning
EASYTRACE_DEBUG	off	1 to log each request while troubleshooting
CI	—	true marks an unknown CI (the run is not Local) and blocks easytrace login
XDG_CONFIG_HOME / APPDATA	~/.config	Where easytrace login stores its credentials

Values of environment variables whose names contain TOKEN, SECRET, PASSWORD or KEY are masked as *** in anything the CLI sends (test output, error messages).