Integrations Setup

Step-by-step setup guides for connecting Replixa to your code host and CI/CD pipeline.

GitHub App

The GitHub App is the recommended installation method. It handles webhooks, authentication, and PR suggestion posting automatically.

  1. Visit Settings → Integrations in your Replixa dashboard
  2. Click Install GitHub App
  3. Select the GitHub organization and repositories to grant access to
  4. Replixa requests only pull_requests: read/write and contents: read
  5. After install, run replixa init in your repo to generate .replixa.yml

GitHub Actions

Add a Replixa review step to any GitHub Actions workflow:

name: Replixa Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review]

jobs:
  replixa:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Run Replixa review
        uses: replicen/replixa-action@v2
        with:
          token: ${{ secrets.REPLIXA_TOKEN }}

GitLab Integration

For GitLab.com and self-managed GitLab instances:

  1. In your Replixa dashboard, navigate to Settings → Integrations → GitLab
  2. Provide your GitLab instance URL and generate a Personal Access Token with api scope
  3. Replixa will configure the webhook on your project automatically

Or via .gitlab-ci.yml:

replixa-review:
  stage: review
  image: node:20-alpine
  only:
    - merge_requests
  script:
    - npm install -g @replicen/cli
    - replixa review --ci --pr $CI_MERGE_REQUEST_IID
  variables:
    REPLIXA_TOKEN: $REPLIXA_TOKEN  # set in GitLab CI/CD variables

Bitbucket

Configure the Bitbucket webhook integration:

  1. In your Bitbucket repository, go to Repository settings → Webhooks → Add webhook
  2. Set URL to https://api.replicen.com/v1/webhooks/bitbucket
  3. Enable triggers: Pull Request Created, Pull Request Updated
  4. Add your Replixa token to Bitbucket Repository variables as REPLIXA_TOKEN