Manage runners
View, share, and manage runners from the Coord web app.
View, share, and manage runners from the Coord web app.
Viewing your runners
The Runners page shows all runners connected to your workspace. Open it from the workspace sidebar.
The page has two tabs:
- My Runners — runners you own.
- All Runners — every runner in the workspace, including runners owned by other members.
Each tab displays a table with the following columns:
| Column | What it shows |
|---|---|
| Runner | The runner's name (editable) and its unique ID. |
| Owner | The workspace member who registered the runner. |
| Sharing | Shows Private (only the owner's jobs), Pending (sharing requested, awaiting approval), or Shared (available to the workspace). |
| Status | Current state: Active (executing a job), Idle (connected but not executing), Offline (not connected), Disabled (prevented from picking up jobs), or Terminated (permanently removed). |
| Capabilities | What the runner can do — for example, local jobs, repository jobs, or specific AI agents like Claude Code, Codex, or Gemini. |
| Jobs | How many jobs the runner is currently executing and its lifetime total (e.g., "0 / 109" means zero active jobs out of 109 completed over the runner's lifetime). |
| Last Heartbeat | When the runner last checked in (for example, "just now" or "3d ago"). |
Runner actions
Each runner row has actions you can take:
- Share / Revoke sharing — share your runner with the workspace so other members' jobs can be picked up by it. If sharing requires approval, the runner enters a Pending state until an admin approves. You can cancel a pending request or revoke sharing at any time.
- Disable / Enable runner — disable a runner to prevent it from picking up new jobs. Jobs already in progress continue. Use this when you want to take a runner offline for maintenance. Click the same button again to re-enable it.
- Deregister runner — permanently removes the runner from the workspace. To reconnect, you need to sign in again from the Coord Runner desktop app.
- Rename runner — click the pencil icon next to the runner's name to edit it inline.
Warning: Deregistering a runner is permanent. The runner disappears from all workspaces and must be re-registered by signing in again from the desktop app.
Downloading the runner
A Download Runner button at the top of the page lets you download the installer for your platform — macOS (ARM64 or x64), Windows, or Linux. This is a shortcut — the same installers are available from the installation guide.
How sharing works
By default, a runner only executes jobs for its owner. When you share a runner, it becomes available to the entire workspace — any member's jobs can be picked up by the shared runner.
Sharing may require admin approval depending on your workspace settings. If approval is required, the runner shows a Pending status until an admin approves the request. You can cancel a pending request if you change your mind.
The workspace setting Auto-share runners on join controls whether new members automatically get access to shared runners. See Workspaces and teams for details on workspace settings.
Next steps
- Runner overview — how the Coord Runner desktop app works
- Installation — download and install the runner
- Configuration — fine-tune runner settings
- Team runners — run multiple runners across your team
- Workspaces and teams — workspace roles and the auto-share setting