config

Configuration management commands for NDCLI. These commands help you view and modify NDCLI settings.

Commands

Command	Description
`config show`	Display current configuration
`config set org`	Set default organization
`config set output`	Set default output format
`config set timezone`	Set the timezone used for timestamps
`config reset`	Reset configuration to defaults

org, output and timezone are the only subcommands config set accepts. Every other setting — including auth.storage — is changed by editing config.yaml directly, or by setting the matching environment variable where one exists. See the Configuration Reference.

config show

Display the current NDCLI configuration including all settings and their values.

ndcli config show

Output

Shows:

Authentication settings (provider, domain, client ID)
Control plane host
Default organization
Output format preference
Auth storage settings
Config file location

Examples

ndcli config show

config set org

Set the default organization for all commands. This saves you from specifying --org on every command.

ndcli config set org [name]

Arguments

Argument	Required	Description
`name`	Yes	Organization name to set as default

Examples

ndcli config set org my-company

ndcli config show

Notes

The organization must exist and you must have access to it
Use ndcli org list to see available organizations
Override per-command with the --org flag

config set output

Set the default output format for all commands.

ndcli config set output [format]

Arguments

Argument	Required	Description
`format`	Yes	One of: `table`, `simple`, `detailed`, `json`

Output Formats

Format	Description
`table`	Tabular format, good for lists
`simple`	Compact bullet-point format
`detailed`	Rich Unicode box drawing (default)
`json`	Machine-readable JSON

Examples

ndcli config set output json

ndcli config set output detailed

config set timezone

Set the timezone NDCLI uses when it renders timestamps and when it interprets timestamps you type without an explicit offset — such as the --at flag on ndcli run.

ndcli config set timezone [zone]

Arguments

Argument	Required	Description
`zone`	Yes	An IANA timezone name, e.g. `America/Sao_Paulo`, `Europe/Berlin`, `UTC`

This writes the output.timezone key. With no timezone configured, NDCLI falls back to the system local timezone.

Examples

ndcli config set timezone America/Sao_Paulo

ndcli config set timezone UTC

Notes

Only display and input parsing are affected — the API always exchanges UTC.
A bare --at "2026-05-12 03:00" is read in this timezone; an RFC3339 value with an offset (2026-05-12T03:00:00Z) ignores it.

config reset

Reset the configuration file to default values. This removes custom settings.

ndcli config reset

Examples

ndcli config reset