Runner
Setup and sign-in
Sign in to the Coord Runner and connect it to your workspace.
After installing the Coord Runner, sign in and connect it to your workspace.
Sign in
The Coord Runner uses a device code flow for authentication — a secure method that does not require you to enter your password in the runner itself.
- Open the Coord Runner.
- Click Sign In. The runner displays a short code.
- Click Open Browser to launch the confirmation page. Enter the code and confirm your identity.
- Once confirmed, the runner is connected to your account. The runner is available across all of your workspaces automatically.
If the browser does not open automatically, you can manually visit the URL shown in the runner and enter the code.
Set your working directory
The runner needs a directory on your machine where it will clone repositories and run agent tasks.
- Choose a directory when prompted, or open the runner settings and find the Runner workspace setting.
- Click Browse and select a folder with enough disk space for your repositories.
Tip: Choose a dedicated folder (e.g.,
~/coord-work) rather than your home directory. This keeps runner files organized and easy to find.
Once set, the runner is online and ready to pick up agentic jobs.
Verify the runner is online
To confirm your runner is connected:
- Go to the Runners page in the Coord web app.
- Your runner should appear in the list with an online status and its last-seen timestamp. Use the My Runners tab to see your own runners, or All Runners to see everyone in the workspace.
Next steps
- Configuration — adjust concurrent jobs, agents, and cleanup settings
- Create your first job — create a job for the runner to execute