Global flags & environment

Common flags

Most commands share these conventions:

--workspace <id>

Target a specific workspace. Falls back to your default context, then a derived value.

--account <id>

Target a specific account. Falls back to your default context.

--branch <branch>

Workspace branch for file/execution commands (default: main).

--json

Emit machine-readable JSON instead of a table.

--page / --page-size / --order-by

Paging and sort controls on list commands.

The CLI reads these when the matching flag isn't provided:

Variable	Equivalent to
`VERENTIS_API_URL`	`login --api-url`
`VERENTIS_API_KEY`	`login --api-key`
`VERENTIS_TOKEN`	`login --token`
`VERENTIS_CONTEXT_PATH`	Path to an execution context the SDK auto-loads

CI without a login step

Export VERENTIS_API_URL and VERENTIS_API_KEY in your pipeline and skip verentis login entirely — commands pick them up automatically.

Credentials, default context and signing keys live under ~/.verentis/ (keys at ~/.verentis/keys/<name>.json).