Your first worker

A worker is where tasks actually run. It needs the project's code, at least one coding agent, and outbound access to the control plane.

Before you start

• Node.js 20 or newer on the machine (Node.js 22.13+ if you want to run plugins).
• A coding agent installed and signed in as the user the worker will run as, for example Claude Code.
• Git configured for that user (name, email, and push credentials if tasks should push).

Install

Build the worker package once from a checkout of the core repository, then run the installer for your operating system:

node scripts/package-worker.mjs
powershell -ExecutionPolicy Bypass -File installers\windows\install-worker.ps1

node scripts/package-worker.mjs
./installers/macos/install-worker.sh

node scripts/package-worker.mjs
./installers/linux/install-worker.sh --linger   # --linger keeps it running after you log out

Each installer checks dependencies, copies the worker, registers autostart as your user, starts it, opens the local UI and runs diagnostics. Details per platform: Windows, macOS, Linux.

Pair

1. In the local UI (http://127.0.0.1:47821), enter the control plane's URL.
2. The worker shows a code. In the dashboard, open the approval page, check the machine details, approve.
3. The worker stores its credential in the OS credential store and connects.

Check

agentctl doctor

The dashboard's Workers page shows the worker online, with its operating system, tools and detected agents. Under Projects in the local UI, the worker lists the repositories it found on its disks.