Guides

Integrations

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

Time: 14 minAudience: Platform 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.