Commands

View all commands

You can see the complete list by running ub-agents help.

$ ub-agents help
ub-agents — project-owned engineering loops on GitHub

usage: ub-agents <command> [options]

commands:
  init                   set up this repository: starter configuration, agent
                         instructions and workflow labels
  check                  validate the configuration and instruction files
  doctor [--json]        check the machine, GitHub access, labels and agent
                         runtimes
  launch [NUMBER]        run the queue in the foreground, or handle one item
  status [NUMBER] [--json]
                         matching work, owners, attempts and why items wait
  cleanup [--apply]      preview or remove stale worktrees and branches
  retry NUMBER           let stopped work run again, with a recorded reason
  approve NUMBER         record approval of an issue's or PR's current input

inside a run, through the launcher's report_command:
  report                 record the run's outcome
  retrospective          post to the agent's retrospective board
  read NUMBER            read an issue or PR as filtered JSON

options:
  -h, --help             show this help; after a command, that command's help
  -v, --version          print the version
  --config PATH          project configuration (default: ub-agents.yaml)