Installation
Build the worker package from the core repository and install it with the installer for Windows, macOS or Linux; uninstall and reinstall.
Build the package
From a checkout of the core repository, with Node.js 20+ and pnpm:
pnpm install
node scripts/package-worker.mjs # creates .deploy/workerA distribution that offers a hosted service can preset it: package-worker.mjs --hosted-url https://… writes
the address into the package, and the worker UI then offers Hosted service when pairing.
Install
| OS | Command | Autostart | Verified |
|---|---|---|---|
| Windows | powershell -ExecutionPolicy Bypass -File installers\windows\install-worker.ps1 | Per-user Scheduled Task at logon; restarted within a minute if it stops | Installed, restarted and uninstalled for real on Windows 11 |
| macOS | ./installers/macos/install-worker.sh | LaunchAgent (KeepAlive) | Syntax-checked only |
| Linux | ./installers/linux/install-worker.sh [--linger] | systemd user service | Syntax-checked only |
Each installer validates dependencies, copies the worker, registers autostart, starts it, opens the local UI and
runs diagnostics. It captures your PATH, so agent CLIs installed through npm, Homebrew or pipx are found.
Uninstall
Run the matching uninstall-worker script. Add -RemoveData (Windows) or --remove-data to also delete
configuration and stored credentials. Project folders are never touched.
Run without installing
For development, run it from the repository with pnpm dev:worker; it prints the local UI link with its access
token.