Set the CLI's display name
You can now set displayName to control the API name in the generated README and reference.md titles and in the crate’s default description. A multi-spec workspace no longer takes its title from the first spec’s info.title; without displayName, it uses a readable form of the binary name (twilio-cli gives “Twilio CLI”).
Accurate reference.md command paths
The generated reference.md now lists the command paths the binary runs:
- A group named like its spec’s
namespaceis hoisted into the namespace (oauth authorize, notoauth oauth authorize). - A slash-separated namespace nests (
messaging bulk-messages create, notmessaging-bulk-messages create). - HEAD and OPTIONS operations, such as CORS preflight endpoints, are no longer listed, since the binary doesn’t expose them.
- Titles no longer double “CLI” when the name already ends in it.
macOS code signing in the release workflow
The generated release workflow now code-signs the macOS binaries when the CLI repository has the CODESIGN_CERTIFICATE, CODESIGN_CERTIFICATE_PASSWORD, and CODESIGN_IDENTITY secrets (an Apple Developer ID certificate). macOS keychain credentials are also read through /usr/bin/security, so one “Always Allow” lasts across upgrades.
Prompts for missing required inputs
When stdin and stderr are both terminals, the CLI prompts for required inputs that no flag, --params, --json, profile, or global parameter supplied. Scripts, CI, and piped runs never prompt and keep the existing “is missing” error. Values marked format: email are now validated before the request is sent.
Guided API-key setup
CLIs with profiles.provisionOperation configured now walk users through creating a key-backed profile in an interactive terminal. auth login and a bare profiles create <name> ask for a profile name and the credential, offer to create an API key with it, and store only the new key. profiles remove offers to revoke the profile’s key. provisionOperation also accepts flag, parameters, and profileParameters.
Create API keys with profiles create --provision
Set profiles.provisionOperation to the operation that creates an API key (for example iam.keys.create). profiles create then gains --provision, which calls that operation with the credentials already in the environment and saves the returned key to the new profile. It’s the create-side counterpart of revokeOperation.
Auth details in dry-run previews
--dry-run output now includes an auth block that reports the endpoint’s security schemes and whether credentials would be attached (resolved, missing, or supplied). In a terminal, the default table format now prints the full request preview (URL, method, query parameters, and body) instead of only the header rows.
profiles set confirms before creating a profile
profiles set <name> no longer creates a missing profile without asking, so a mistyped name can’t save credentials to a new, unintended profile. In a terminal it asks first, offering a similarly named existing profile before asking whether to create the new one; declining writes nothing. When stdin or stderr isn’t a terminal, set on a missing profile fails with a hint instead of creating it. Scripts that relied on set to create profiles need the new --yes / -y flag or a profiles create call first. Updating an existing profile is unchanged.
Selected profiles outrank environment variables
A selected profile’s stored values now take precedence over environment variables however the profile was selected: -p, <PREFIX>_PROFILE, or profiles use. Previously only a profile named with -p outranked the environment, so a profile made active with profiles use lost to any exported <PREFIX>_BASE_URL, <PREFIX>_RETRIES, or credential variable. Every profile-capable value resolves as explicit flag → selected profile → environment variable → spec default; environment variables fill only the values the profile leaves unset. Unprofiled invocations are unchanged. auth status lists the profile’s credential source before the environment variable, and profiles current reports when an environment variable is supplying a credential the profile doesn’t store.
Profile-storable transport settings
profiles set now accepts <PREFIX>_TIMEOUT_SECS, <PREFIX>_PROXY, <PREFIX>_CA_BUNDLE, <PREFIX>_INSECURE, and <PREFIX>_USER_AGENT_SUFFIX, so each profile can carry its own request timeout, proxy, CA bundle, TLS verification setting, and User-Agent suffix. Values are validated on save, child profiles inherit them, and a selected profile’s value outranks the exported variable. <PREFIX>_CONNECT_TIMEOUT_SECS stays environment-only. The root --help footer now lists every environment variable the CLI reads, including one per server URL variable.