Guides

Integrations

Connect Refactor to your existing GitHub and CI workflows through ReactorAI so runs trigger automatically at the right pull request lifecycle events.

14 minPlatform engineers and team maintainers

Connect GitHub in ReactorAI

External developers should connect GitHub using the ReactorAI dashboard integration flow instead of managing webhook infrastructure manually.

GitHub integration setup flow

# In https://reactorai.codes dashboard:
# 1) Open Integrations -> GitHub
# 2) Install the ReactorAI GitHub app
# 3) Select repositories to authorize
# 4) Enable PR-based run triggers for your project

CI review artifact refresh

Add a CI step that refreshes hosted review artifacts for each PR. Use a platform-issued developer key stored in repository secrets.

GitHub Actions baseline job

name: refactor-review

on:
  pull_request:
    branches: [main]

jobs:
  refactor-review:
    runs-on: ubuntu-latest
    env:
      REFACTOR_API_KEY: ${{ secrets.REACTORAI_DEVELOPER_KEY }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - name: Install Refactor CLI
        run: python -m pip install --upgrade refactorai-cli
      - name: Verify auth context
        run: refactor whoami
      - name: Refresh review artifacts
        run: refactor review .

Developer-side integration checks

Keep a lightweight local review step before push so CI and ReactorAI runs start from a clean branch state.

Pre-push verification flow

# Local branch checks before push
refactor review .
refactor status

# After push, monitor run and approvals in ReactorAI dashboard

Integration readiness checklist

GitHub app installed with least-privilege repository access.
ReactorAI developer key stored as protected CI secret.
Project is configured for PR-based publish workflows.
CI gate outcomes are visible in pull request checks and team alerts.