Getting started

Global Options

Global options are shared by multiple Orchestor CLI data commands. Availability depends on the command; check its --help output. Local configuration commands list their supported options on their own reference pages.

Help

Use --help to display usage and supported options for a command.

orc brands list --help

Workspace

Use --workspace to select a workspace by ID. You can also set the ORCHESTOR_WORKSPACE_ID environment variable.

orc brands list --workspace <workspace-id>

JSON output

Use --json for compact JSON or --pretty for indented JSON. Both wrap the response in an envelope.

orc brands list --json
orc brands list --pretty

Output format

Use --format to select json, table, yaml, csv, or raw. The default is human-readable output.

orc brands list --format table
orc brands list --format csv

Field selection

Use --field to extract a value from the response. Dotted paths are supported. --fields is an alias.

orc brands list --field id

Raw output

Use --raw to print extracted values without JSON quotes or an envelope. Array values are printed one per line for use in other commands.

orc brands list --field id --raw

File output

Use --output to write the result to a file instead of standard output.

orc brands list --json --output brands.json

Pager

Use --no-pager to disable the interactive pager. The pager is disabled by default when standard output is not a terminal.

orc brands list --no-pager

Dry run

Use --dry-run to preview the request without sending it to the API.

orc brands list --dry-run

Confirmation

Use --yes to skip confirmation prompts for destructive operations. This option does not grant permissions.

orc brands delete <brand-id> --yes

Page size

Use --page-size on paginated list commands to set the maximum number of items per page. It maps to the API’s limit parameter.

orc brands list --page-size 25

All pages

Use --page-all on paginated list commands to stream every page as NDJSON, one record per line. Do not combine it with --json, --pretty, or another output format.

orc brands list --page-all
orc brands list --page-all --output brands.ndjson

Standard input

Use --stdin to read a JSON resource definition from standard input when creating or updating a resource. --from-stdin is an alias.

orc brands create --stdin --dry-run < brand.json

Request timing

Use --timing to print request duration to standard error. Timing stays separate from the data on standard output, so it can be used with JSON output.

orc brands list --json --timing