These docs track main. Latest release: v1.0.0.

antigravity-booster
ReferenceCLI

agb sweep

Apply one operation to many targets by converting a sweep spec into a plan and running it.

agb sweep converts a sweep spec (one operation template applied to many targets) into a plan and runs it with the same engine as agb run. The spec defaults to sweep.json.

Known issue (T-CODE-FIXES-AUDIT item 1)

The global --project value is passed to sweepToPlan (sweep conversion), but sweepToPlan accepts only a targets option (sweepToPlan signature), so the value is dropped while the sweep is converted to a plan. It is still passed to the run itself.

Synopsis

agb sweep <sweep.json>

Same operation × many targets, then run.

This command takes no flags.

Behavior

  • The spec's repo is resolved to an absolute path, the spec is converted with sweepToPlan, and the resulting plan is validated like any other plan (sweep dispatch).
  • operation must contain {target}, and targets come from targets[] or targetGlob (sweep validation). The full format is in Sweep schema.
  • Exit codes match agb run: 1 for an invalid sweep, 2 when any target fails, 0 otherwise.

See the Sweeps guide.

On this page