← CLI reference

rad-experiment-list(1) General Commands Manual rad-experiment-list(1)

rad-experiment-list - List all experiments, grouped by experiment branch

rad-experiment list [-r|--repo] [--reproduced] [-q|--quiet] [--unreproduced] [--pretty] [--redacted] [--all-schemas] [--json] [--author] [--since] [--delegates-only] [--label] [--branch] [--merged] [--unmerged] [--landable] [-h|--help]

Lists experiments in a repository, grouped by experiment branch.

By default experiments are grouped under their branch with a header showing the branch name, author, best delta, and positive/total count. Experiments not on any branch appear under an "unassigned" section at the end. Branch groups are sorted by best improvement first; experiments within each group are sorted oldest first.

--json emits one JSON object per line (JSONL) with a "branch" field (string or null). Two filters are applied by default: redacted experiments are hidden unless --redacted is passed, and experiments whose schema_version is below the current SCHEMA_VERSION are hidden unless --all-schemas is passed. Both gates match what cc-httpd's list/branch/repo views show.

The --branch filter has an unusual shape: <peer-prefix>/<branch-name>. The peer is everything before the first slash, so branch names containing slashes work (e.g. z6MkfEaY/experiments/inner-loop/foo). Membership rule matches the cc-httpd branch page: the experiment must be authored by that peer, its primary metric must match the branch tip's primary metric, and its base or candidate commit must be reachable from that tip. The base-or-candidate split is what surfaces orphan discards on the branch alongside kept commits.

--merged, --unmerged, and --landable filter which branch groups are shown. --merged and --unmerged are mutually exclusive. --landable and --merged are also mutually exclusive — already-merged branches are trivially uninteresting as a future base, so they are reported as "not landable".

Repository path or Radicle RID (defaults to current directory)
Only show reproduced experiments
Suppress non-error output to stderr
Only show unreproduced experiments
Pretty-print JSON output (for human inspection; agents should omit)
Include redacted experiments
Include experiments published with an older schema version. By default, list hides COBs whose schema_version is below the crate's current SCHEMA_VERSION — same gate cc-httpd applies to rendered list/branch/repo views — so the output reflects the latest data model. Use this flag to inspect older COBs in place
Output as JSON lines (one JSON object per line)
Filter by author (DID key prefix, e.g. z6Mk...)
Only show experiments created on or after this date (YYYY-MM-DD)
Only show experiments authored by repository delegates
Filter to experiments with this label
Filter to experiments reachable from a peer's experiment-branch tip whose primary metric matches the branch tip's primary metric. Format: <peer-did-or-prefix>/<branch-name>. Branch names containing slashes are supported — the peer is everything before the first '/'
Only show branches whose tip is reachable from canonical main
Only show branches whose tip is NOT yet reachable from canonical main
Only show branches that 3-way merge cleanly onto canonical main (i.e. could be used as a future starting point without conflicts). Already-merged branches are excluded
Print help (see a summary with '-h')

EXAMPLES:

Everything in the repo, grouped by experiment branch:

rad-experiment list

Only reproduced results:

rad-experiment list --reproduced

Everything by a specific peer (prefix match on DID):

rad-experiment list --author z6MkfEaY

Everything published this month, delegates only:

rad-experiment list --since 2026-04-01 --delegates-only

Experiments tagged "shipped":

rad-experiment list --label shipped

Everything reachable from a specific peer's branch:

rad-experiment list --branch z6MkfEaY/experiments/inner-loop-hoist

Only branches that can cleanly merge onto main:

rad-experiment list --landable

Only branches not yet merged into main:

rad-experiment list --unmerged

Pipe to jq for ad-hoc analysis:

rad-experiment list --json | jq -r 'select(.delta_pct_x100 > 500) | .id'

list