Team runners
Run multiple Coord Runners across your team or on shared machines.
Scale execution by running multiple Coord Runners across your team.
How runners are linked to your account
When you sign in to the Coord Runner, it is linked to your account — not to a specific workspace. Your runner automatically follows you to every workspace you are a member of. There is no need to connect it to each workspace individually.
When you submit an agentic job, you choose where it runs:
- My Runners (default) — routes the job to runners registered to your own account.
- Team Runners — routes the job to shared runners of job team members.
- Any Runner — routes the job to whichever runner is available first, yours or shared.
- Specific runner — routes the job to a runner you select by name.
Multiple runners per workspace
A workspace can have any number of runners available to it. When a job becomes ready, the first available runner picks it up. Your team can process more jobs in parallel by adding more runners.
Each runner operates independently — if one goes offline, the others continue working.
Team member runners
The simplest way to scale is to have each team member run the Coord Runner on their own machine. Each person:
- Installs the runner.
- Signs in with their Coord account.
Their runner automatically appears in every workspace they belong to and picks up jobs alongside everyone else's runners.
Shared machine runners
You can also run the Coord Runner on a shared machine — a dedicated workstation, a server, or a CI environment. This provides execution capacity that does not depend on any individual team member being online.
To set up a shared runner:
- Install the runner on the shared machine.
- Sign in with a Coord account that has access to the target workspace.
- Configure the runner workspace directory and agent settings.
- Leave the runner running.
Note: The account used to sign in determines the runner's workspace access and counts toward that account's plan limits.
Managing runners from the web app
The Runners page in the Coord web app gives you an overview of all runners in your workspace — separate from the desktop runner app itself.
- My Runners tab — shows runners registered to your account. You can rename, share, or remove them.
- All Runners tab — shows every runner in the workspace. Admins and owners can manage any runner.
For each runner, the table shows:
- Runner — the runner's name and short ID.
- Owner — the person who registered the runner.
- Sharing — whether the runner is Private (only available to its owner) or Shared (available to other workspace members).
- Status — whether the runner is online, offline, idle, active (executing a job), or disabled.
- Capabilities — badges showing which agents and execution modes are available on that runner.
- Jobs — how many jobs the runner is currently executing and its lifetime total.
- Last Heartbeat — when the runner last checked in with the workspace.
A Download Runner button in the top-right corner links to the installation page for setting up new runners.
Disabling a runner
Admins can disable a runner in a specific workspace. A disabled runner stops picking up new jobs in that workspace but can still work in other workspaces it is connected to. Re-enable it when you want it to resume.
Sharing a runner
You can share your runner with other workspace members, making it available to execute jobs on their behalf. Use the share action on the Runners page to manage sharing.
Removing a runner
To permanently remove a runner from your account, use the remove action on the Runners page. This deregisters the runner — it stops appearing in any workspace and cannot pick up jobs until it is registered again.
Next steps
- Configuration — adjust concurrent jobs and other settings
- Troubleshooting — common issues with runners