Runner quick setup

The Coord Runner is a desktop app that executes agentic jobs on your machine. This page covers the quick path to getting it running. For the full setup guide, see Set up a runner.

Download

1. Open your workspace and go to the Runners page.
2. Click Download Runner and select your platform from the dropdown: macOS (Apple Silicon), macOS (Intel), Windows, or Linux.

Install

Run the installer for your platform. On macOS, you may need to allow the app in System Settings > Privacy & Security if macOS Gatekeeper blocks it. On Windows, you may need to click More info > Run anyway if Windows SmartScreen shows a warning.

Sign in

1. Open the Coord Runner.
2. Click Sign In. The runner displays a short code.
3. Click Open Browser to launch the confirmation page. Enter the code and confirm your identity.
4. Once confirmed, the runner is connected to your account. The runner is available across all of your workspaces automatically.

Set your working directory

Choose a directory on your machine where the runner will do its work. This is where the runner clones repositories and runs agent tasks. Once set, the runner is online and ready to pick up agentic jobs from your workspaces.

Next steps

• Set up a runner — full installation and configuration guide
• Configuration — adjust concurrent jobs, agent preferences, and more
• Create your first job — create an agentic job and watch the runner execute it