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 quality gate enforcement

Add a CI step to block merges when critical policy checks fail. Use a platform-issued developer key stored in repository secrets.

GitHub Actions baseline job

name: refactor-quality-gate

on:
  pull_request:
    branches: [main]

jobs:
  refactor-check:
    runs-on: ubuntu-latest
    env:
      REFACTOR_PLATFORM_URL: https://reactorai.codes
      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 refactor
      - name: Verify auth context
        run: refactor whoami
      - name: Secret and config guardrail
        run: refactor check --strict

Developer-side integration checks

Keep a lightweight local check 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 check --strict

# 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.