CLI

CLI — command reference

Every command at a glance, grouped by area. Follow the linked page for flags, examples, and the behavior in depth.

Auth & diagnostics

CommandPurpose
rollout loginAuthenticate a workspace and store an API key.
rollout logoutRemove the stored API key.
rollout whoamiShow the saved API key and workspace.
rollout checkSend a diagnostic trace through the ingest path.
rollout config pathPrint the config file path.

Covered in Install & login and Configuration.

Datasets

CommandPurpose
rollout datasets inspect <uri>Show columns, splits, and sample rows of a source.
rollout datasets pull <uri>Convert JSONL / CSV / HF / Parquet into a Harbor folder (--upload to send).
rollout datasets import <path>Import an existing Harbor folder into Rollout.

Covered in Datasets.

Verifiers

CommandPurpose
rollout verifiers create <spec.json>Create or reuse a verifier from a local spec file.

Covered in Verifiers.

Optimization

CommandPurpose
rollout optimize sync-targetsSync local @rollout.optimize targets to Rollout.
rollout optimize createSync target, import dataset/verifier, and create a run.
rollout optimize dry-run <id>Check target module, splits, verifiers, and DSPy install — no model calls.
rollout optimize run [id]Run the optimization. With no id, also creates everything first.

Covered in Running & watching runs and the end-to-end guide. rollout optimizations create remains as a compatibility alias — prefer optimize.

Benchmarks

CommandPurpose
rollout benchmarks listList runnable benchmark packages.
rollout benchmarks pull <name>Add a benchmark package to the workspace.
rollout benchmarks run <name>Start a hosted run against an agent endpoint.

Covered in Benchmarks.

Imports

CommandPurpose
rollout import raindrop previewPreview what an import would pull.
rollout import raindrop runTransform a source (and optionally send it).
rollout import report <dir>Inspect a local import workspace.
rollout import validate <file>Validate a transformed events JSONL file.
rollout import resume <dir>Resume sending from a checkpoint.
rollout import send <file>Send a transformed JSONL file manually.

Covered in Imports.