Set up a runner

Install the Coord Runner on your machine so it can execute agentic jobs from your workspace.

Download

You can download the Coord Runner from within the app:

1. Open the Runners page from the workspace sidebar.
2. Click Download Runner in the top-right corner.
3. Select the installer for your platform:

• macOS (Apple Silicon) — .dmg installer for M-series Macs
• macOS (Intel) — .dmg installer for Intel Macs
• Windows — .exe installer
• Linux — .AppImage or .deb package

You will also have the option to download the runner during onboarding after you first create your workspace.

Install

macOS

1. Open the .dmg file and drag the Coord Runner to your Applications folder.
2. Open the app. If macOS displays a security warning (Gatekeeper), go to System Settings > Privacy & Security and click Open Anyway.

Windows

1. Run the .exe installer and follow the prompts.
2. If Windows Defender SmartScreen shows a warning, click More info and then Run anyway.

Linux

1. For .AppImage: make the file executable (chmod +x) and run it.
2. For .deb: install with your package manager.

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.

Configure the runner

1. Choose a working directory — a folder on your machine where the runner will clone repositories and run agent tasks. Pick a location with enough disk space.
2. Set the maximum concurrent jobs — how many jobs the runner can work on at the same time. Start with 1 or 2 and increase as needed.

Select AI agents

The Coord Runner supports multiple AI agents:

• Claude Code — Anthropic's coding agent
• Codex — OpenAI's coding agent (macOS and Linux only)
• Gemini CLI — Google's coding agent

The runner detects which agents are installed on your machine. If an agent is missing, the runner shows instructions for installing it.

You can enable or disable specific agents in the runner settings. Only enabled agents will be used to execute jobs.

Verify the runner is online

After configuration, the runner should show as Online in the app. You can also verify in Coord:

1. Open the Runners page from the workspace sidebar.
2. Your runner should appear in the list with an online status.

The runner is now ready to pick up agentic jobs from your workspace.

Next steps

• Create your first job — create an agentic job and watch the runner execute it
• Configuration — fine-tune runner settings
• Agent capabilities — details on each supported agent