Codecora Codecora

GitHub Setup

Install Codecora as a GitHub App for automatic code reviews on your pull requests.

⚡ Easiest Setup - 2 Clicks

Prerequisites

  • A GitHub account
  • A repository where you have admin permissions
  • An OpenAI-compatible API key (OpenAI, Anthropic, Groq, etc.)

Step 1: Install GitHub App

  1. Click the button below to install Codecora from the GitHub Marketplace:
    Install Codecora GitHub App
  2. GitHub will ask you to authorize the app. Review the permissions and click "Install & Authorize".
  3. Choose whether to install on:
    • All repositories: Recommended for personal accounts
    • Selected repositories: Choose specific repos to enable

Step 2: Configure AI Provider

After installing the GitHub App, you'll be redirected to the Codecora dashboard where you can configure your AI provider:

  1. Choose your provider: Select from OpenAI, Anthropic, Groq, or any OpenAI-compatible API.
  2. Add your API key: Paste your API key. Your key is encrypted and stored securely.
  3. Test connection: Click "Test Connection" to verify your API key works.
  4. Save settings: Click "Save" to apply your configuration.

🔒 Your API key is encrypted at rest and in transit.

We use industry-standard encryption to protect your keys. Your keys are never shared with third parties.

Step 3: Start Reviewing

That's it! Codecora will now automatically review all pull requests in your enabled repositories.

  • Create a new pull request
  • Codecora analyzes the commit diffs
  • Review comments appear within 30 seconds

Configuration Options

In the dashboard, you can customize:

  • Review severity: Choose which issues to report (Critical, Major, Minor, Refactor)
  • Categories: Enable/disable Security, Performance, Style, and Best Practices checks
  • Auto-collapse: Choose how to handle multiple walkthroughs on the same PR
  • AI model: Select which AI model to use for reviews

Troubleshooting

App not reviewing PRs?

  • Check that the repository is enabled in the GitHub App settings
  • Verify your AI provider API key is valid and has credits
  • Check the dashboard for any error messages

Permission errors?

  • Ensure the GitHub App has permission to write pull request comments
  • Reinstall the app if permissions were changed

Webhook not delivering?

  • Check that webhooks are enabled in your repository settings
  • Verify the webhook URL matches: https://codecora.dev/webhooks/github
  • Check recent webhook deliveries in GitHub repository settings

Next Steps