Guides

Add a launcher

Run more launchers on other machines, or let teammates run one. They share one queue through GitHub, and a claim keeps two launchers off the same item.

On the new machine

Install, clone and log in with an account that has write access.

$ brew install uberblick-ai/tap/ub-agents
$ gh auth login
$ git clone https://github.com/your-org/your-project
$ cd your-project

Check and launch

$ ub-agents doctor
$ ub-agents launch

Which accounts count

By default every account with write access or higher can run a launcher. To allow only some, list them, and use the same list on every machine. See Launcher accounts.

launchers: [ub-bot, alice]

Several launchers on one machine

Each run gets its own worktree and scratch directory, and nothing else is checked. Runs from two launchers on one machine, in this project or another, can collide on shared resources: a Docker database, a fixed port, a shared cache. Give each run its own, for example by naming them after the worktree, and stop them in the cleanup hook. If that's not possible, run one launcher per machine.

Keep versions together

When a release note says launchers must be upgraded together, stop every launcher for the project before upgrading any. See Upgrading.