Configuration
Configure the Coord Runner workspace directory, concurrent jobs, and agent preferences.
Fine-tune how the Coord Runner operates on your machine. All settings are accessible from the runner's settings panel.
Startup settings
Control how the Coord Runner behaves when your machine starts and when the app opens.
- Start on login — automatically launch the Coord Runner when you log in to your computer.
- Start minimized — open the runner minimized to the system tray instead of showing the main window.
- Start runner on open — automatically start picking up jobs when the app opens, without needing to manually start the runner.
Runner settings
Runner name
Give your runner a display name to identify it in the Runners page. This is especially useful when your workspace has multiple runners — you can tell them apart at a glance.
Runner workspace
The directory where the runner stores cloned repositories and working files. You can change it at any time by clicking Browse in the settings.
Choose a location with enough disk space for the repositories your agents will work on. Each job that operates on a repository clones the codebase to this directory.
Repository cleanup
After a job completes, the runner can clean up inactive repositories to free disk space. The Cleanup inactive repos after setting controls how long the runner keeps repositories that are no longer in use.
Keeping repositories longer speeds up future jobs on the same codebase because the runner can pull changes instead of cloning from scratch. Shorter cleanup intervals save disk space.
Max concurrent jobs
Set the maximum number of jobs the runner can work on simultaneously. This controls how many AI agents run in parallel on your machine.
- Default: 1
- Recommended: The runner suggests a value based on your machine's available memory. Start there and adjust based on performance.
- Maximum: The runner allows values up to 500, but your workspace plan's concurrency limit applies server-side.
Higher concurrency means more parallel work, but each running agent uses CPU, memory, and network bandwidth.
Agent selection
The runner supports multiple AI agents. You can enable or disable each one:
| Agent | Description |
|---|---|
| Claude Code | Anthropic's coding agent. Available on all platforms. |
| Codex | OpenAI's coding agent. Available on macOS and Linux. |
| Gemini CLI | Google's coding agent. Available on all platforms. |
The runner automatically detects which agents are installed on your machine. Agents that are not installed show setup instructions. Only enabled agents are used to execute jobs.
To re-detect agents after installing a new one, click Rescan Capabilities & Tools in the settings.
Appearance
Choose between light and dark themes for the runner interface.
Auto-updates
The runner checks for updates every 6 hours by default. You can toggle Auto-check for updates off if you prefer to check manually with the Check for Updates button.
Next steps
- Agent capabilities — details on each supported agent
- Team runners — running multiple runners across a team
- Troubleshooting — common issues and solutions