Environment variables

The CLI reads its configuration from environment variables at startup. They’re the right place to set credentials and overrides in CI, Docker, or shell scripts that drive multiple commands.

Reference

Variable	Description
`TALKVALUE_TOKEN`	API token used for every request. When set, it takes precedence over any saved profile and skips `auth login` entirely.
`TALKVALUE_PROFILE`	Name of the saved profile to use as the default. Overridden by `--profile`.
`TALKVALUE_API_URL`	Override the TalkValue data API base URL. Used for staging environments.
`TALKVALUE_AUTH_API_URL`	Override the auth server base URL used by `auth login` / token refresh.
`NO_COLOR`	When set to any value, disables ANSI color in table output. Same as `--no-color`.
`FORCE_COLOR`	When set to any value, forces ANSI color even when stdout is not a TTY (for example, CI logs).

Order of precedence

For overlapping settings, CLI flags win over environment variables, which win over saved profiles or defaults:

Setting	Flag	Env var	Default
Auth profile	`--profile <name>`	`TALKVALUE_PROFILE`	Active profile
API base URL	`--api-url <url>`	`TALKVALUE_API_URL`	Built-in production URL
Color	`--no-color`	`NO_COLOR` / `FORCE_COLOR`	Auto-detect TTY
Output format	`--format` / `--json`	—	Auto-detect TTY

API tokens are the exception. TALKVALUE_TOKEN in the environment always overrides any saved profile and has no flag equivalent. See Authentication.

Common setups

CI environment

export TALKVALUE_TOKEN=<your-token>
talkvalue path person list --json

The token replaces interactive login. Store it in your CI provider’s secret store.

Docker

ENV TALKVALUE_TOKEN=<your-token>
RUN talkvalue path overview --json > /tmp/overview.json

Inject the token at build or run time depending on your secrets workflow.

Multiple profiles in one shell

export TALKVALUE_PROFILE=staging
talkvalue path person list             # staging org
talkvalue path person list --profile prod   # prod org for this command only

Staging API

export TALKVALUE_API_URL=https://staging.example.trytalkvalue.com
export TALKVALUE_AUTH_API_URL=https://staging-auth.example.trytalkvalue.com
talkvalue auth login

Authentication. TALKVALUE_TOKEN vs profiles, precedence rules.
Global flags. Flag equivalents for the env vars above.
Output format. How color and format auto-detection work.

Get Started

Global

Commands

Recipes

AI Agents

Reference

Reference

Order of precedence

Common setups

CI environment

Docker

Multiple profiles in one shell

Staging API

​Reference

​Order of precedence

​Common setups

​CI environment

​Docker

​Multiple profiles in one shell

​Staging API

​Related

Reference

Order of precedence

Common setups

CI environment

Docker

Multiple profiles in one shell

Staging API

Related