GitHub Integration
Roboticks installs as a first-class GitHub App on your organization. Every PR routes through HMAC-verified webhooks. Check Runs report test status, requirement coverage, and merge-blocking safety status. GitHub OIDC is the in-CI authentication path, so no personal access tokens or long-lived secrets need to be stored as repo secrets.
Features
- •Install once per org; link any repo to a Roboticks project
- •HMAC-verified webhook receiver behind FIFO SQS for reliability
- •PR Check Runs with requirement-coverage status
- •GitHub OIDC → short-lived Roboticks token (no PATs)
- •Multi-repo projects with aggregated coverage
- •GHES (GitHub Enterprise Server) supported on Enterprise tier
Getting Started
- 1
Install on your GitHub org
From /github/install in the dashboard, follow the OAuth flow to install the App on selected repos or the whole org.
- 2
Link repos to a project
Each Roboticks project can link many repos. One repo can be designated default but it's just visual; coverage aggregates regardless.
- 3
Add roboticks.yaml
Drop a config file in the repo root with the test entry point, runner pool preference, and optional matrix. The next push triggers a test run.
For the full setup guide with code examples, payload formats, and troubleshooting, see the GitHub integration documentation.
Documentation
For setup guides, API references, and technical details, visit the full documentation.