Set up GitHub integration

Connect your GitHub organization or personal account to Coord so agents can work on your repositories.

Link your GitHub account

Before installing Coord Bot, connect your GitHub identity to Coord:

1. Open Integrations under Settings in the sidebar.
2. Click Link GitHub Account.
3. Authorize Coord to access your GitHub identity.

This lets Coord discover your organizations and personal accounts.

Install Coord Bot

Coord Bot is the GitHub App that enables agents to create branches, open pull requests, and sync review feedback.

1. On the Integrations page (under Settings in the sidebar), click Install GitHub App. This opens GitHub in a new tab.
2. Choose the organization or personal account where you want to install Coord Bot.
3. Choose which repositories to grant access to:
   • All repositories — Coord Bot can access any repository in the account, including future ones.
   • Selected repositories — choose specific repositories. You can change this later.
4. Click Install on GitHub.
5. Return to Coord and click Link next to the newly detected installation.

You should see the installation appear under Linked Integrations with an "Active" status.

What permissions Coord Bot needs

Coord Bot requests these GitHub permissions:

• Read and write code — the agent creates branches and pushes 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.
• Read and write checks, actions, commit statuses, and workflows — Coord monitors your CI pipeline to determine when it is safe to merge.
• Read repository metadata — Coord lists available repositories in your workspace.

Coord Bot only accesses repositories you have explicitly granted. It does not access private repositories you have not selected.

Managing integrations

The Integrations page (Settings > Integrations in the sidebar) is titled "GitHub Integrations" with the subtitle "Manage GitHub App integrations for your workspace." This is where you view and manage all GitHub accounts linked to your workspace.

Linked integrations table

Each linked GitHub account appears as a row with the following columns:

Edit available repos

Click Edit available repos next to an integration to open a dialog where you control which repositories from that GitHub account are accessible to your workspace. Use this to add or remove repos without unlinking the entire integration.

Changing repository access on GitHub controls which repos the app can access. The Edit available repos dialog controls which of those repos are available in your workspace.

When creating an agentic job with repository context, you select from the available repositories.

Change repository access on GitHub

To add or remove repositories from the GitHub side:

1. Go to your GitHub organization or account settings.
2. Find Coord Bot under Installed GitHub Apps.
3. Adjust which repositories Coord Bot can access.
4. Changes are reflected in Coord when you refresh the integrations page.

Unlink an integration

Click Unlink integration next to an integration to remove the connection between that GitHub account and your workspace. Jobs that reference repos from this account will no longer be able to create branches or pull requests. This does not uninstall the GitHub App from GitHub — it only removes the link in Coord.

You can re-link the installation at any time.

Uninstall from GitHub

To remove Coord Bot entirely:

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

Existing pull requests created by agents remain on GitHub. Jobs that referenced those repositories still show their history, but no new repository-based jobs can run until the integration is reinstalled.

Install on additional accounts

At the bottom of the Integrations page, click Install GitHub App to start the GitHub App installation flow for a new organization or account. After installing on GitHub, return to the Integrations page and click Refresh to see the new integration.

Troubleshooting

If an installation shows a Suspended badge in your integrations settings, it means an organization admin has suspended Coord Bot on GitHub. Jobs will not be able to create issues or push code until the installation is restored from the GitHub organization settings.

Next steps

• Review agent work — review pull requests created by agents
• Create your first job — create a repository-based agentic job
• Create jobs from GitHub issues — use the #coord tag to create jobs from GitHub issues
• GitHub integration — how the integration works end-to-end