GitHub Actions integration

Add Aucert to your GitHub Actions workflow to run AI-powered mobile tests on every pull request.

Basic workflow

.github/workflows/aucert.yml

name: Aucert Tests
on:
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Aucert CLI
        run: npm install -g @aucert/cli

      - name: Build app
        run: ./gradlew assembleDebug

      - name: Run Aucert tests
        env:
          AUCERT_API_KEY: ${{ secrets.AUCERT_API_KEY }}
        run: aucert run --output junit

      - name: Upload results
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: aucert-results
          path: ./aucert-results/

Configuration

Store your AUCERT_API_KEY in GitHub repository secrets:

1. Go to Settings → Secrets and variables → Actions
2. Click New repository secret
3. Name: AUCERT_API_KEY, Value: your API key from aucert.ai

tip

Use --output junit to generate JUnit XML reports that GitHub Actions can display in the test summary.

What's next

• CLI commands — Full command reference
• Configuration — Customize test behavior