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

Start GitHub Connection

In your Overcut workspace, go to Integrations and click Connect GitHub.
2

Install the Overcut GitHub App

Click Connect to be redirected to GitHub. Choose whether to install the app for your personal account or specific organizations. Grant the necessary permissions for repositories and issues.
3

Select Repositories

Choose which repositories the Overcut app should have access to. You can select all repositories or specific ones based on your needs.
4

Complete the Setup

After installing the app and selecting repositories, you’ll be redirected back to Overcut. The connection will be established and you can start using GitHub in your workflows.
To add or remove repositories later, use the installation’s Configure page on GitHub (Organization settings -> GitHub Apps -> Overcut -> Configure); Overcut picks up the change automatically.

​
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

  • 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 shows repositories included in the app installation - review the installation’s Configure page on GitHub
  • Check your GitHub user permissions for specific repositories
For what agents can do once connected (repositories, issues, pull requests, triggers), see the GitHub overview.