GitHub

Coord integrates with GitHub so AI agents can work on your repositories — creating branches, making changes, and opening pull requests for your team to review.

How it works

When you create an agentic job with repository context, Coord creates a GitHub issue in the linked repository to track the work. Then the Coord Runner:

Clones the repository (your project's codebase hosted on GitHub) to its local workspace directory.
Creates a branch — a separate copy of the code where the agent makes changes without affecting the main version.
Executes the AI agent with the job instructions.
Commits the agent's changes (saves a snapshot of the code changes).
Pushes the branch to GitHub and opens a pull request — a proposal to merge the agent's changes into your main codebase.
The job moves to Awaiting Review (waiting for your team to check the agent's work).

If the agent determines no code changes are needed, the job moves to Awaiting Review without a pull request. You can still approve and close the associated issue.

Setting up the integration

Install Coord Bot

Coord Bot is the GitHub App that connects your repositories to Coord. You can install it on a GitHub organization or a personal GitHub account.

Open Integrations under Settings in the sidebar.
Click Link GitHub Account to connect your GitHub identity. This lets Coord discover your organizations and personal accounts.
Click Install GitHub App. This opens GitHub in a new tab.
Choose the organization or personal account where you want to install Coord Bot.
Choose repository access:
- All repositories — Coord Bot can access any repository in the account, including future ones.
- Selected repositories — grant access to specific repositories only.
Confirm the installation.
Return to Coord and click Link next to the newly detected installation.

Tip: You can install Coord Bot on multiple organizations and personal accounts. A single installation can also be linked to more than one workspace.

Required permissions

Coord Bot requests the following permissions when you install it:

Permission	Why it is needed
Read and write code	The agent creates branches and pushes code changes.
Read and write pull requests	The agent opens pull requests and syncs review feedback.
Read and write issues	Coord creates a GitHub issue for each repository-context job and updates it as work progresses.
Read and write checks, actions, commit statuses, and workflows	Coord monitors your CI pipeline (automated tests and builds) to determine when it is safe to merge. Also required to push branches when the repository uses GitHub Actions.
Read repository metadata	Coord lists available repositories when you create a job.

Coord Bot only accesses the repositories you explicitly grant. It does not read private repositories you have not selected.

Manage repository access

After installation, you can adjust which repositories Coord Bot can access:

From Coord: Open Integrations under Settings in the sidebar. Click the settings icon next to an installation to open the Edit Repos modal, where you select or deselect individual repositories available to your workspace.
From GitHub: Go to your organization or account settings, find Coord Bot under Installed GitHub Apps, and change whether it has access to all repositories or only selected ones.

Changing repository access from GitHub controls which repos the app can access. The Coord Edit Repos modal controls which of those repos are available in your workspace.

The pull request flow

Creating work

When an agent starts a repository-context job:

Coord creates a GitHub issue in the linked repository to track the job.
The runner creates a branch named after the job.
The agent makes its changes on this branch.
When the agent finishes, the runner pushes the branch and opens a draft pull request.
The pull request contains the agent's code changes, ready for review.

You can see the linked GitHub issue and pull request in the job's overview tab.

Reviewing work

You can review the agent's work from either Coord or GitHub:

In Coord — open the job detail panel to view the pull request diff, approve, or request changes. Coord handles the merge process.
On GitHub — review the code diff, leave line comments, and submit a review. Feedback syncs back to Coord automatically.

Revision cycle

If you request changes:

The agent receives your feedback.
A new attempt begins. The agent addresses your comments.
The runner pushes updates to the same pull request.
The job returns to Awaiting Review.

This cycle continues until you approve.

Approving and merging

When you approve a job in Coord, you choose what happens next. The approval dialog presents these options:

Ready PR — convert the draft pull request to "ready for review" on GitHub.
Merge PR — merge the pull request after CI checks pass. Requires Ready PR.
Delete branch — remove the branch after merging.
Close issue — close the linked GitHub issue.

If CI checks are still running when you approve, Coord monitors them in the background. Once all checks pass, Coord completes the merge automatically. You can close the dialog — the approval continues in the background.

If you choose not to merge, the pull request stays open on GitHub for you to manage manually. The job moves to Done either way.

When CI checks fail

If CI checks fail after you approve, Coord pauses the approval and notifies you. You can:

Request changes — send the job back to the agent with feedback about the failure.
Approve anyway — mark the job as done without merging.
Cancel approval — return the job to Awaiting Review and optionally convert the pull request back to a draft.

If the merge itself is blocked (for example, by branch protection rules or required reviews on GitHub), Coord shows a warning. You can resolve the issue on GitHub and retry the merge from Coord.

Creating jobs from issues

You can create Coord jobs directly from GitHub issues by adding #coord tags to the issue body. This works in any repository where Coord Bot is installed.

Add #coord to create a user job.
Add #coord:agent:claude to create an agentic job that works on the repository.
Add workspace and configuration tags to customize the job.

When Coord creates the job, Coord Bot comments on the issue with a link and a summary of the job settings. If something goes wrong (for example, a missing workspace tag), Coord Bot comments with instructions on how to fix it.

For the full tag reference and setup instructions, see Create jobs from GitHub issues.

Disconnecting

There are two ways to remove the GitHub integration:

Unlink from your workspace — keeps Coord Bot installed but removes the connection to this workspace:

Open Integrations under Settings in the sidebar.
Find the installation and click the unlink icon.

Jobs with repository context for this installation will no longer be able to create GitHub issues. You can re-link the installation at any time.

Uninstall from GitHub — removes Coord Bot entirely from your organization or account:

Go to your GitHub organization or account settings.
Navigate to Installed GitHub Apps.
Find Coord Bot and click Uninstall.

If an organization admin suspends the Coord Bot installation on GitHub, jobs will not be able to create issues or push code until the installation is restored. Coord shows a "Suspended" badge next to the affected installation in your integrations settings.

In both cases, existing pull requests remain on GitHub and jobs that referenced repositories retain their history.

Set up GitHub integration — step-by-step setup guide
Create jobs from GitHub issues — use #coord tags to create jobs from issues
Review agent work — reviewing pull requests
Jobs — repository vs. local execution context

On this page