Skip to main content
Use this path when you use Overcut’s managed service (Overcut Cloud). You install the managed Overcut GitHub App from within your workspace; there are no credentials to manage, no app to create, and no webhook to register.
Not your setup? See Which setup do I need? If you run Overcut on your own infrastructure, follow GitHub from self-hosted Overcut instead.

​
Prerequisites

  • A GitHub account with access to repositories you want to connect
  • Admin permissions to install GitHub Apps in your repositories or organization
  • An active Overcut Cloud workspace

​
Connect

1

Open the GitHub connection

In your Overcut workspace, go to Integrations, select Add Provider, then select GitHub. GitHub opens in a popup.
2

Install the Overcut GitHub App

Choose the personal account or organization where you want to install the app. You need permission to install GitHub Apps for that account or organization.
3

Grant repository access

Choose whether the Overcut GitHub App can access all repositories or only selected repositories. For least-privilege access, select only the repositories you plan to use with Overcut.
4

Confirm the connection

Complete the installation in GitHub. Overcut confirms the connection and lists the account or organization under Integrations.
App access determines which repositories Overcut can offer; it does not register them. Follow Repositories to register and activate repositories for automations and projects. To connect another organization or account, select Add Provider and choose GitHub again. Each installation appears separately under Integrations. To add or remove repository access for an existing installation, use its Configure page on GitHub (Organization settings -> GitHub Apps -> Overcut -> Configure); Overcut picks up the change automatically. For popup and confirmation details shared by all providers, see Connect a provider.

​
Permissions

The managed Overcut GitHub App requests the following permissions:

​
Repository Access

  • Contents: Read and write access to repository code
  • Issues: Read and write access to issues and comments
  • Pull Requests: Read and write access to pull requests and reviews
  • Actions: Read and write access to trigger and monitor GitHub Actions workflows
  • Metadata: Read access to repository metadata

​
Organization Access

  • Members: Read access to organization members (for assignment features)
  • Organization: Read access to organization information
These permissions allow Overcut to fully integrate with your GitHub workflow while maintaining security and following GitHub’s best practices.

​
Troubleshooting

​
Connection issues

  • If the GitHub popup was blocked, allow popups for Overcut and try again
  • Ensure you have admin permissions in your GitHub organization
  • Try disconnecting and reconnecting the integration
  • Check that your GitHub account is accessible and not rate-limited

​
Missing repositories

  • The integration only offers repositories included in the app installation. Review the installation’s Configure page on GitHub
  • Check your GitHub user permissions for specific repositories
  • If the repository is accessible but not yet available to automations or projects, register and activate it in Overcut
For what agents can do once connected (repositories, issues, pull requests, triggers), see the GitHub overview.