GitHub
Connect Clearly AI to GitHub.
Overview
Connect GitHub to Clearly AI so Clearly AI can use your repositories as project context and review the code in those repositories.
The GitHub integration supports two authentication methods:
- Personal Token
- OAuth 2.0
For help choosing between them, see Integrations.
Instructions
Prerequisites
- A Clearly AI account with access to the Integrations page
- A GitHub account that can access the repositories you want Clearly AI to review
- For Personal Token, a GitHub personal access token with access to the repositories Clearly AI should read
- For OAuth 2.0 with an organization-wide connection, permission to create shared connections in Clearly AI and any GitHub organization approval your company requires
Open the GitHub integration
In Clearly AI, go to Integrations and select GitHub from the list of enabled integrations. The GitHub configuration panel opens.
Choose an authentication method
Select either Personal Token or OAuth 2.0 under GitHub Authentication.
Option A. Personal Token
Use this option when you want to paste a GitHub token directly into Clearly AI.
- Select Personal Token.
- In Personal Key, paste your GitHub personal access token.
- Click Apply & Test to save the configuration and verify the connection.
Option B. OAuth 2.0
Use this option when you want GitHub to handle sign-in and authorization.
- Select OAuth 2.0.
- On the Integrations page, choose Personal (User) or Shared (Workspace) for who can use this connection:
- Personal (User) means only you can use it.
- Shared (Workspace) means anyone in your Clearly AI organization can use it.
- Click Connect with GitHub.
- Sign in to GitHub if prompted, then approve Clearly AI's access request.
- Return to Clearly AI and click Apply & Test.
Use the connection in Clearly AI
After the test succeeds, the GitHub connection is available for Clearly AI projects that need repository context. The repositories and code Clearly AI can review depend on the access granted by your token or GitHub authorization.
Which method should you use?
| Method | Best when | Notes |
|---|---|---|
| Personal Token | You want the quickest setup and prefer to manage the token yourself | Access is limited to the repositories and permissions granted to that token |
| OAuth 2.0 | You want a guided sign-in flow or need a shared connection | Supports Personal (User) and Shared (Workspace) scope in Clearly AI |
FAQs
Related
- Integrations - Understand when to use Personal Token versus OAuth 2.0
- Concepts - Learn how integrations provide project context in Clearly AI