Commands

ub-agents doctor

Run ub-agents doctor during setup or when a launch fails. It checks your machine, the configuration, GitHub access, labels and agent CLIs, and shows a fix for every warning.

$ ub-agents help doctor
usage: ub-agents doctor [options]

Check machine, GitHub and runtime prerequisites. Create missing workflow labels
only after a confirmed interactive prompt. Show warnings and failures with a
summary per area by default; use --verbose for every check. Use during setup or
to diagnose launch failures; required failures exit nonzero.

options:
  --json                 emit versioned prerequisite results
  --verbose              show the full per-check list (does not change --json)
  --config PATH          project configuration (default: ub-agents.yaml)
  -h, --help             show this help

examples:
  ub-agents doctor
  ub-agents doctor --verbose
  ub-agents doctor --json