CLI reference

Every redcrown subcommand and flag.

`redcrown attest`

Download a signed attestation for a completed run

Flag	Description	Default
`run_id`
`--out`	output file (default <run_id>-attestation.json)
`--api-url`		`https://api.redcrown.ai`

Build an experiment JSON from a public corpus (primock57, mmlu-pro)

Flag	Description	Default
`source`	public corpus source (omit when using --from-csv/--from-jsonl)
`--out`	path to write the experiment JSON
`--limit`	cap the number of (audio, reference) items
`--corpus-dir`	path to an existing corpus checkout (skips cloning)
`--quality-bar`	quality bar a candidate must clear; default = the dataset's published bar (mmlu-pro 0.75), NOT 0.0
`--monthly-minutes`	projected monthly audio minutes for the $/mo column	`20280`
`--no-clone`	do not clone; require --corpus-dir to point at a checkout	`False`
`--ids-file`	path to a newline-separated list of clip ids; builds exactly those items (the pinned benchmark subset). Applied after --limit, so do not combine them
`--from-csv`	build from a CSV with input + reference columns (text tasks)
`--from-jsonl`	build from a JSONL with input + reference fields (text tasks)
`--task`	task kind for --from-csv/--from-jsonl
`--input-col`	input column/field name (default 'input')	`input`
`--reference-col`	reference column/field name (default 'reference')	`reference`

Run an experiment JSON locally and print the report

Flag	Description	Default
`path`	path to an experiment JSON file
`--sample`	run a bundled offline sample with the demo provider (no keys)
`--report-json`	also write the full results (receipts included) as an upload-schema JSON for redcrown push
`--audio-base`	base URL for per-item audio (item_audio = base + id + .mp3)
`--concurrency`	number of provider calls to run at once (default 1, sequential; raise it for many-candidate token benchmarks)	`1`
`--repeat`	run each candidate N times and report a run-to-run quality stdev (default: the experiment's repeat_n, or 1). Note: this makes N times the API calls, so N times the eval spend. Tip: set params.seed on a candidate for a provider that supports seeded sampling.

Upload a locally-run eval's aggregated results JSON into RedCrown

Flag	Description	Default
`path`	path to a results JSON file (the upload schema)
`--api-url`	RedCrown API base URL	`https://api.redcrown.ai`
`--token`	access token (or set REDCROWN_TOKEN); your RedCrown/Supabase bearer token

Flag	Description	Default
`--api-url`	RedCrown API base URL	`https://api.redcrown.ai`

Delete the stored RedCrown credentials

Push a local eval's results JSON to RedCrown as a cloud run

Flag	Description	Default
`path`	results JSON from `redcrown eval --report-json`
`--api-url`		`https://api.redcrown.ai`
`--app-url`		`https://app.redcrown.ai`
`--org`	workspace (org) id; default personal org
`--experiment`	append the run to this standing experiment id
`--no-receipts`	strip per-item receipts/references before upload (confidential outputs never leave this machine)	`False`
`--proof-link`	mint and print a shareable proof link for the pushed run	`False`

Verify a RedCrown attestation file offline

Flag	Description	Default
`path`
`--key`	a JWKS file to verify against (offline); default: fetch the file's key_url

Generated from source. Last verified 2026-07-02.