Polyglot Automation
Connect Polyglot to GitHub: checks on every pull request, human review for generated translations, and translation PRs opened for you.
Polyglot Automation is a Team and Scale capability in early access. The local CLI and open GitHub Action remain available on every plan.
What you get
- A stable native Polyglot / i18n Check with new, existing, and resolved findings.
- Policy that starts informational, immutable policy snapshots, and shared run history.
- GitHub OIDC authentication without a long-lived Polyglot project secret in the caller.
- Opt-in catalog sync from your repo's default branch.
- Human review by default for generated translations.
- Exact preview, pristine-base and candidate verification, and a catalog-only pull request.
Prerequisites
- A Team or Scale organization and an owner or administrator completing setup.
- A GitHub repository containing a committed
polyglot.toml. - Permission to install GitHub Apps on the selected repository.
- GitHub Actions enabled for the repository.
- A publication verification command in
[publish]before creating translation PRs.
Quickstart
- Open Dashboard → Automation → Settings for the intended project.
- Install the Checks App on only the repositories you want Polyglot to inspect.
- Select the repository and the path to
polyglot.toml. - Copy the exact generated workflow to
.github/workflows/polyglot.yml, commit it, and push it to the default branch. - Leave the page open while Polyglot verifies the workflow, or use I've pushed it — verify setup.
- Run or inspect the first scan. New connections begin informationally. Then finish Merge protection in the dashboard; setup is not merge-blocking until Polyglot verifies the required Check and its expected App source.
- When publication is needed, install the separate Publisher App and accept the catalog disclosure.
- Generate, review, preview, verify, and create the translation pull request.
GitHub cannot register a workflow until it exists on the default branch. The dashboard's generated caller is the source of truth: it pins a complete managed-workflow commit and lists the currently supported operations. Do not copy a mutable SHA from documentation.