Skip to content

Show and change CLI settings.

Terminal window
caplo config

Settings are saved in config.yaml in the configuration directory: CAPLO_CONFIG_DIR, else ~/.config/caplo ($XDG_CONFIG_HOME/caplo), or %AppData%\caplo on Windows. caplo workspace use saves the selected workspace there too.

Examples

Terminal window
caplo config list
caplo config set credential-storage file

Commands

Show one setting.

Terminal window
caplo config get <key>

Examples

Terminal window
caplo config get api-url

Show every setting.

Terminal window
caplo config list [flags]

Shows the saved settings, the production defaults for those not saved, and the selected workspace. Defaults are not saved.

Examples

Terminal window
caplo config list
caplo config list -o json

Flags

Flag Value Default Description
--output, -o string table output format: table, json, or yaml

Change one setting: api-url, issuer, client-id, credential-storage.

Terminal window
caplo config set <key> <value>

Changes a saved setting: api-url, issuer, client-id (the OAuth client, caplo-cli by default), or credential-storage (keychain or file). Changing api-url clears the selected workspace. Run caplo auth login afterwards to start a session with the new setting.

Examples

Terminal window
caplo config set credential-storage file
caplo config set api-url https://api.staging.example.com