Integrations
Hyrax connects to the tools your team already uses. GitHub is the core integration — it's how Hyrax reads your code and ships its work. Ticketing through Linear is opt-in.
| Integration | Status | What it does |
|---|---|---|
| GitHub | Generally available | Reads your code, opens PRs and issues, posts PR review comments and check runs. |
| Linear | Generally available | Files a ticket when you fix an observation on a configured repo. |
GitHub
After you sign in, connect your GitHub organization by installing the Hyrax GitHub App on the repositories you want analyzed. There are no personal access tokens to manage and nothing to paste — once the App is installed, Hyrax reads your code and runs jobs securely. See Security for how access works.
Public repositories can also be connected in anonymous mode — read-only, no App required. See Public & private repositories.
What Hyrax writes back
Everything Hyrax opens on your repo is clearly attributed:
| Surface | Behavior |
|---|---|
| Pull requests | Titled with a [Hyrax] prefix. Fixes open a PR on a dedicated hyrax/ branch; you review and merge it like any other PR. |
| Issues | Also [Hyrax]-prefixed. |
| PR reviews | A single review comment summarizing the findings (each tagged must-fix or consider), plus a Hyrax Review check run on the PR head commit. Make the check a required status check to gate merges on must-fix findings. |
Hyrax never merges its own pull requests, and by default its work always lands as a reviewable PR. (A repo can opt into a commit-direct mode where fixes land as commits on a branch you choose — see Fixes.)
Once a repo has PR review enabled, Hyrax reviews pull requests automatically as they're opened and updated, posting within a couple of minutes. On Pro and Team, when CI fails on a Hyrax fix PR, Hyrax revises the change to get it green, bounded so it won't loop indefinitely.
Linear (tickets)
Hyrax can mirror your fixes into Linear so the work shows up where your team already tracks it. Linear is the only ticketing integration.
Setup
- An account owner connects Linear by storing a Linear API key in your workspace settings.
- Enable ticket config on the repositories where you want tickets created.
When you fix an observation on a ticket-configured repo, Hyrax creates a [Hyrax]-prefixed Linear ticket for that observation and links it to the finding. When the fix PR opens, Hyrax adds the PR link as an attachment on that ticket, so the ticket and the fix PR reference each other — a clean trail from "Hyrax found this" to "here's the change."
Once a ticket exists, Hyrax keeps its status in step with the observation:
| Observation | Linear ticket moves to |
|---|---|
| Created | A "todo"-type state |
| Closed as fixed or expired | A "done"-type state |
| Dismissed | A "cancelled"-type state |
Hyrax maps to the state types your team has configured, so it works with your existing Linear workflow.
See also
- Pull request review — how automatic reviews work.
- Fixes — what gets turned into PRs and tickets.