verdictan configure
Use verdictan configure to save a region for a terminal profile and list local profile names.
These commands work locally. They do not require an API connection or sign-in.
The CLI connection file is separate from the gateway's policy-config.yaml.
For the resolved region and its source, use verdictan regions current.
Usage
verdictan configure set region <region> [--profile <name>] [--config <path>]
verdictan configure get region [--profile <name>] [--config <path>]
verdictan configure list-profiles [--config <path>]Options
| Option | Applies to | Effect |
|---|---|---|
<region> | set region | Required. Accepts global or two lowercase words separated by a hyphen, such as eu-west. |
--profile <name> | set region, get region | Select the profile. The default is default. An empty name is invalid. |
--config <path> | All | Select the CLI connection file. Otherwise, use VERDICTAN_CONFIG, then ~/.verdictan/config.yaml. |
--config can also appear before the subcommand, such as verdictan configure --config ./cli.yaml list-profiles.
These commands print text. They do not accept --json, --api-url, or a credential flag.
list-profiles does not accept --profile because it lists all local profile names.
Save and read a region
-
Save a region for a named profile:
verdictan configure set region eu-west --profile work -
Read that profile's saved region:
verdictan configure get region --profile work
set region creates the parent directory and file when necessary.
It writes profiles.<name>.default_region and retains other configuration entries.
The command rewrites YAML, so existing comments and formatting can change.
It prints the selected region, profile, and destination path.
The configuration includes this entry:
profiles:
work:
default_region: eu-westget region prints only the saved region and a newline.
It first reads the profile's default_region, then the root-level default_region if the profile has none.
It does not read VERDICTAN_REGION or query the API catalog.
If neither saved value exists, it stops with no region configured for profile '<name>'.
To keep connection settings in a project file:
verdictan configure set region eu-west --profile work --config ./cli.yaml
verdictan configure get region --profile work --config ./cli.yamlThe command checks the region's format. It does not confirm that the region exists in the API catalog. A saved region does not change the API URL or the provider locality in a gateway configuration.
List profiles and sign in
verdictan configure list-profilesThe command prints one name per line in byte-sorted order, without duplicates.
The list always includes default.
It also includes names from the config file's profiles map, its root profile value, and stored terminal credentials.
An alternate --config changes the configuration source, not the credential store.
A listed profile does not establish that its credential exists or remains valid. Use the same name when you sign in and examine identity:
verdictan auth login --profile work
verdictan auth whoami --profile workThe environment variable VERDICTAN_API_TOKEN takes priority over the selected terminal session.
For all credential sources, see Authentication.
ACP uses kalkidan as its default profile. Most terminal commands use default.
Desktop authorization stores credentials in the system keyring.
configure list-profiles lists terminal configuration and credential names, not ACP agent definitions or all desktop accounts.
See verdictan acp for coding-agent profiles.
Limits and failure behavior
| Condition | Result and action |
|---|---|
| Region has an invalid format | The write stops. Use a key such as eu-west, us-east, or global. |
| Configured region is absent from the catalog | The write succeeds. Query verdictan regions list before using that region. |
| Selected file does not exist | set region creates it. get region and list-profiles stop if an explicit path cannot be read. |
| YAML is invalid or the root is not a mapping | Correct the file before writing a setting. |
profiles or a profile entry is not a mapping | The write stops without replacing that entry. Correct its structure. |
| No saved region exists | get region stops with an error. Set the region for that profile. |
| Directory or file cannot be written | Correct the destination path or its access permissions. |
There are no configure commands to delete a profile, change its API URL, or store a token.
Use the connection flags supported by each command and the authentication workflow for credentials.
Complete command reference
Select a command for its complete input table. Default input means the value used when that option is omitted.
A value marked Not set can still come from configuration or the environment, as described above.
Set uppercase variables in example templates to your own resource IDs and paths before use.
See CLI scripting for quoting, output streams, confirmation, and exit codes.
verdictan configure set region [OPTIONS] <REGION>| Input | Required | Default input | Meaning and accepted values |
|---|---|---|---|
<REGION> | Yes | Not set | Region key. This value does not change the API origin or provider locality. |
--profile <PROFILE> | No | default | Profile to read or write. Use the same profile for related commands. |
--config <CONFIG> | No | Not set | CLI connection file. Use VERDICTAN_CONFIG or the standard profile file when omitted. |
--help (-h) prints help. The global --lang and --region options follow the shared input rules.
Result: Text reports the saved region, profile, and configuration path.
Example template:
verdictan configure set region eu-westverdictan configure get region [OPTIONS]| Input | Required | Default input | Meaning and accepted values |
|---|---|---|---|
--profile <PROFILE> | No | default | Profile to read or write. Use the same profile for related commands. |
--config <CONFIG> | No | Not set | CLI connection file. Use VERDICTAN_CONFIG or the standard profile file when omitted. |
--help (-h) prints help. The global --lang and --region options follow the shared input rules.
Result: The saved region followed by a newline.
Example template:
verdictan configure get regionverdictan configure list-profiles [OPTIONS]| Input | Required | Default input | Meaning and accepted values |
|---|---|---|---|
--config <CONFIG> | No | Not set | CLI connection file. Use VERDICTAN_CONFIG or the standard profile file when omitted. |
--help (-h) prints help. The global --lang and --region options follow the shared input rules.
Result: One local terminal profile name per line, sorted without duplicates.
Example template:
verdictan configure list-profilesNext steps
- verdictan regions: examine region resolution and query the catalog.
- verdictan auth: sign in to a named profile.
- CLI overview: find shared connection options.