rollout
Sign up free

CLI

CLI — configuration

The CLI keeps a small config file with your API key and the API URL. Everything in it can be overridden by an environment variable or a per-command flag.

Config file

The default config path is:

text
~/.rollout/config.json

Print it at any time:

shell
rollout config path

Environment overrides

VariableOverrides
ROLLOUT_CONFIG_DIRDirectory holding config.json
ROLLOUT_APP_URLBrowser app URL
ROLLOUT_API_URLAPI URL used by whoami, check, imports
ROLLOUT_BASE_URLSingle-origin shorthand for app + API
ROLLOUT_API_KEYWorkspace API key

Permissions

The CLI enforces tight permissions when it writes config:

text
~/.rollout              0700~/.rollout/config.json  0600

whoami, check, logout

Inspect the saved key and workspace, send a diagnostic trace, or clear the stored key:

shell
rollout whoami     # saved API key + workspacerollout check      # diagnostic imported trace through the ingest pathrollout logout     # remove the stored API key

Tip

check is the fastest way to confirm your key, network, and API URL are all working before you start a longer job like an optimization run.

Per-command overrides

Override the API URL or key for a single command without touching the saved config — useful for testing against a local backend:

shell
rollout check \  --api-url http://127.0.0.1:8080 \  --rollout-api-key rl_...