← CLI reference

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

rad-experiment-label - Add or remove labels on an experiment (delegates only)

rad-experiment label [-r|--repo] [--remove] [--json] [-q|--quiet] [--pretty] [-h|--help] <ID> [LABELS]

Adds or removes labels on an experiment. Restricted to repo delegates — the underlying action is rejected by the storage layer otherwise.

Labels are free-form short identifiers (shipped, flaky, nominated) following the standard Radicle label rules. The command writes back the full label set in a single action, so concurrent edits from different delegates follow normal COB merge semantics.

Repository path or Radicle RID (defaults to current directory)
Remove the specified labels instead of adding them
Output as JSON
Suppress non-error output to stderr
Pretty-print JSON output (for human inspection; agents should omit)
Print help (see a summary with '-h')
<ID>
Experiment ID
[LABELS]
Labels to add

EXAMPLES:

Add one label:

rad-experiment label 5574144 shipped

Add several labels at once:

rad-experiment label 5574144 reviewed nominated

Drop a label:

rad-experiment label 5574144 nominated --remove

Machine-readable result:

rad-experiment label 5574144 shipped --json

label