Connecting GitHub
Connect GitHub to Symbi so your agents can review pull requests and post structured code reviews for human approval.
Info
The GitHub integration is currently in Beta. Core code review flows work, but we're still refining edge cases and performance at scale. We welcome feedback while we finalize the integration.
What GitHub Enables
Once connected, your code review agent can:
- Read pull requests — fetch PR metadata, author, base/head refs, labels, and state
- Inspect diffs — get the full unified diff for changed code (up to 500 KB)
- List changed files — see every file touched with addition and deletion counts
- Read file contents — fetch any file at a specific commit or branch for full context
- Read PR comments — see existing review threads and discussion history
- Check CI status — fetch check run results before recommending approval; the agent won't approve a PR with failing or still-pending checks
- Draft a review — produce a structured verdict (Comment / Request Changes / Approve) with inline comments anchored to specific files and lines
The agent never posts directly to GitHub. Every review draft routes to the Operation Center for a human to approve, edit, override, or decline before it is published.
GitHub is a company-only integration. Your Personal Assistant does not have direct GitHub access.
Connect via GitHub App
GitHub connects via a GitHub App installation, not an OAuth token. This gives Symbi scoped, organization-level access without exposing personal credentials.
- Open Settings → Connectors
- Find GitHub and click Connect GitHub
- You're redirected to GitHub to install the Symbi App on your organization
- Select which repositories to grant access to, or choose all repositories
- Click Install — GitHub redirects back and Symbi confirms the connection
Only Owner and Admin users can connect GitHub.
After installation, Symbi automatically discovers your accessible repositories. They appear as selectable resources when you configure a code review agent.
Repository Discovery
Symbi discovers your repositories immediately after connection and registers them as resources your agents can bind to.
Open Settings → Connectors → GitHub to see the Registered Resources section. It lists every repository Symbi has registered, along with:
- Which agents are currently using it — or Unused if no agent is bound to it yet
- An Unregister button to remove a repository you no longer need
To remove a repository, click Unregister next to it. If an agent is still bound to that repository, Symbi blocks the removal and tells you which agents to update first — unbind the repository in each agent's setup, then return here to unregister.
To register additional repositories, click Discover more at the top of the Registered Resources section and select the repositories you want to make available.
Tip
Start by binding a single low-risk repository — an internal tool or experimental project — before connecting your main production repo. This lets you evaluate review quality on real PRs before rolling out broadly.
Webhook Triggers
Symbi listens for GitHub pull request events and starts a review cycle when a PR is:
- Opened — a new pull request is created
- Synchronized — new commits are pushed to an open PR
- Ready for Review — a draft PR is marked ready
Each event starts one agent review. If a PR receives additional commits after the first review, the agent sees the prior review in context and focuses on whether the new commits address earlier feedback — rather than re-reviewing the full diff from scratch.
Review Flow
- A pull request event arrives at Symbi
- The agent reads the diff, file list, existing comments, CI check results, and repository metadata
- It produces a structured draft: verdict + summary + inline comments anchored to files and lines
- The draft appears in the Operation Center → Review Queue for a human reviewer
- The reviewer approves, edits, overrides, or declines the draft
- On approval, Symbi posts the review to GitHub on the agent's behalf
Loop Protection
By default, a code review agent will run up to 5 review cycles per PR before escalating to a human. This prevents excessive re-review on PRs that receive many small commits in rapid succession. The limit and escalation behavior are configurable per agent from the Behavior tab.
Common Patterns
- Automated first-pass review — an agent reviews every PR as soon as it opens, cutting the time senior reviewers spend on mechanical checks
- Security gate — an agent focused on injection, authentication, and secret handling reviews every PR before it reaches your engineering team
- Junior developer coaching — an agent leaves specific, constructive comments on junior engineers' PRs before the broader team weighs in
Security
Symbi connects via GitHub App with installation-scoped permissions. Credentials (the installation ID and org context) are AES-256 encrypted at rest. You can revoke the Symbi App installation at any time from GitHub → Organization Settings → GitHub Apps, or remove it from Symbi's Connectors page.
What's Next?
- Connect Linear to cross-reference PR reviews with project issues
- Connect Slack to receive review notifications in your engineering channel
- Learn about the Operation Center to manage review approvals
Info
GitHub-integrasjonen er for øyeblikket i Beta. Grunnleggende kodegjennomgangsflyter fungerer, men vi finjusterer fortsatt kanttilfeller og ytelse i stor skala. Vi tar gjerne imot tilbakemeldinger mens vi ferdigstiller integrasjonen.
Hva GitHub muliggjør
Når tilkoblingen er på plass, kan kodegjennomgangsagenten din:
- Lese pull requests — hente PR-metadata, forfatter, base/head-referanser, etiketter og tilstand
- Inspisere diff-er — hente den fullstendige enhetlige diff-en for endret kode (opptil 500 KB)
- Liste endrede filer — se alle filer som er berørt med antall tillegg og slettinger
- Lese filinnhold — hente en fil ved en bestemt commit eller gren for full kontekst
- Lese PR-kommentarer — se eksisterende gjennomgangstråder og diskusjonshistorikk
- Sjekke CI-status — hente sjekkresultater før anbefaling om godkjenning; agenten godkjenner ikke en PR med mislykkede eller ennå ventende sjekker
- Utarbeide en gjennomgang — produsere en strukturert konklusjon (Kommentar / Be om endringer / Godkjenn) med inline-kommentarer forankret til spesifikke filer og linjer
Agenten publiserer aldri direkte til GitHub. Alle gjennomgangsutkast sendes til Operation Center for en person å godkjenne, redigere, overstyre eller avvise før de publiseres.
GitHub er en selskapskun-integrasjon. Den Personlige Assistenten din har ikke direkte GitHub-tilgang.
Koble til via GitHub-app
GitHub kobler til via en GitHub App-installasjon, ikke et OAuth-token. Dette gir Symbi avgrenset tilgang på organisasjonsnivå uten å eksponere personlige legitimasjonsopplysninger.
- Åpne Innstillinger → Koblinger
- Finn GitHub og klikk Koble til GitHub
- Du videresendes til GitHub for å installere Symbi-appen i organisasjonen din
- Velg hvilke repositories som skal få tilgang, eller velg alle repositories
- Klikk Installer — GitHub omdirigerer tilbake og Symbi bekrefter tilkoblingen
Kun Eier- og Administrator-brukere kan koble til GitHub.
Etter installasjonen oppdager Symbi automatisk de tilgjengelige repositoriene dine. De vises som valgbare ressurser når du konfigurerer en kodegjennomgangsagent.
Oppdagelse av repositories
Symbi oppdager repositoriene dine umiddelbart etter tilkobling og registrerer dem som ressurser agentene dine kan binde seg til.
Åpne Innstillinger → Koblinger → GitHub for å se Registrerte ressurser-seksjonen. Den lister opp alle repositories Symbi har registrert, sammen med:
- Hvilke agenter som bruker det for øyeblikket — eller Ubrukt hvis ingen agent er tilknyttet det ennå
- En Avregistrer-knapp for å fjerne et repository du ikke lenger trenger
For å fjerne et repository klikker du Avregistrer ved siden av det. Hvis en agent fortsatt er tilknyttet det repositoryet, blokkerer Symbi fjerningen og forteller deg hvilke agenter som må oppdateres først — fjern tilknytningen i hver agents oppsett, og gå deretter tilbake hit for å avregistrere.
For å registrere flere repositories klikker du Oppdag mer øverst i Registrerte ressurser-seksjonen og velger repositoriene du vil gjøre tilgjengelige.
Tip
Start med å binde et enkelt lavrisiko-repository — et internt verktøy eller et eksperimentelt prosjekt — før du kobler til det viktigste produksjonsrepositoriet. Dette lar deg vurdere gjennomgangskvaliteten på ekte PR-er før du ruller det ut bredt.
Webhook-utløsere
Symbi lytter etter GitHub pull request-hendelser og starter en gjennomgangssyklus når en PR:
- Åpnes — en ny pull request opprettes
- Synkroniseres — nye commits pushes til en åpen PR
- Merkes som klar for gjennomgang — en utkast-PR merkes som klar
Hver hendelse starter én agentgjennomgang. Hvis en PR mottar ytterligere commits etter første gjennomgang, ser agenten den tidligere gjennomgangen i kontekst og fokuserer på om de nye committene adresserer tidligere tilbakemelding — fremfor å gjennomgå hele diff-en på nytt.
Gjennomgangsflyt
- En pull request-hendelse ankommer Symbi
- Agenten leser diff-en, fillisten, eksisterende kommentarer, CI-sjekkresultater og repository-metadata
- Den produserer et strukturert utkast: konklusjon + oppsummering + inline-kommentarer forankret til filer og linjer
- Utkastet vises i Operation Center → Gjennomgangskø for en menneskelig gjennomgangsperson
- Gjennomgangspersonen godkjenner, redigerer, overstyrer eller avviser utkastet
- Ved godkjenning publiserer Symbi gjennomgangen til GitHub på agentens vegne
Sløyfebeskyttelse
Som standard kjører en kodegjennomgangsagent opp til 5 gjennomgangssykluser per PR før den eskalerer til en person. Dette forhindrer overdrevne gjennomganger av PR-er som mottar mange små commits i rask rekkefølge. Grensen og eskaleringsvirkemåten kan konfigureres per agent fra Oppførsel-fanen.
Vanlige mønstre
- Automatisert første gjennomgang — en agent gjennomgår alle PR-er så snart de åpnes, og kutter tiden seniorutviklere bruker på mekaniske sjekker
- Sikkerhetsport — en agent fokusert på injeksjon, autentisering og håndtering av hemmeligheter gjennomgår alle PR-er før de når ingeniørteamet ditt
- Coaching av juniorutviklere — en agent legger igjen spesifikke, konstruktive kommentarer på juniorutviklerens PR-er før det bredere teamet ser dem
Sikkerhet
Symbi kobler til via GitHub App med installasjonsavgrenset tilgang. Legitimasjonsopplysninger (installasjons-ID og organisasjonskontekst) er AES-256-kryptert. Du kan tilbakekalle Symbi App-installasjonen når som helst fra GitHub → Organisasjonsinnstillinger → GitHub Apps, eller fjerne den fra Symbis Koblinger-side.
Hva er neste?
- Koble til Linear for å krysshenvise PR-gjennomganger med prosjektissues
- Koble til Slack for gjennomgangsvarsler i ingeniørkanalen din
- Lær om Operation Center for å håndtere gjennomgangsgodkjenninger