The PromQL expression can be passed as the positional argument or through the --expr option. Enclose it in single quotes so the shell does not expand it.
Reference
Query options: --expr PromQL expression (alternative to the positional argument) --from Range start (ISO 8601, Unix timestamp, or relative duration, e.g., 2025-10-23T07:00:00Z, 7d, now-1h) --to Range end (ISO 8601, Unix timestamp, or relative duration; defaults to now) --since Lookback window before --to (or now); mutually exclusive with --from (default 1h when a range is requested) --step Range query resolution step, e.g., 15s, 1m, 5m (default 60s) --time Evaluation time for an instant query (ISO 8601, Unix timestamp, or relative like now-5m); mutually exclusive with --from/--to/--sinceContext options: --profile Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable --org Override the organization. The default organization can be set in your profile by using the `cpln profile update` commandFormat options: --output, -o Set the output format [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"] --color Colorize the output [boolean] [default: true] --ts Timestamp format if the output format is text (e.g., --output=text) [choices: "iso", "local", "age"] --max Maximum number of records to show. A value less than 1 will return all records. [number] [default: 50]Request options: --token Override the authorization token --endpoint Override the API URL --insecure, -k Ignore TLS errors [boolean]Debug options: --verbose, -v Enable verbose output to stderr [boolean] [default: false] --debug, -d Show all HTTP communications [boolean] [default: false]Options: --help Show help [boolean]