# GitHub

> Install the Fixter GitHub App so investigations can open pull requests on the affected repository.

GitHub is only needed if you want an AI agent to write the fix for you at the end of an
[investigation](/using-fixter/investigations/). Investigating, reporting root cause, and
answering follow-ups all work without it, as does fixing the code yourself or handing
the investigation to your own AI coding agent.

## Connect

Setup is self-serve, two ways. In the app, open
[Settings > Integrations](https://app.fixter.dev/settings/integrations) and use the
GitHub **Connect** button. Or, from Slack, type this to the Fixter bot:

```
connect github
```

Either route gives you an install link for the Fixter GitHub App. Follow it, choose
which repositories to grant, and the installation is bound to your workspace when the
callback completes.

## What access is used for

With the App installed, an AI agent reads the affected repository and opens a pull
request with the fix on it. This is in beta: every pull request is reviewed by someone
at Fixter before it reaches you. Nothing is ever merged for you.

Repositories are cloned into temporary isolated environments that exist only for the
duration of an investigation or fix generation. Your code is not stored beyond that,
and caches are invalidated when the run ends.

Fixter does not build or test the change it proposes. Review it as you would any change
from a colleague.

## If the fix flow does not work

- **Fixter says it cannot reach the repository.** The App is installed but that
  repository was not granted to it. Adjust the installation on GitHub.
- **Nothing happens after `connect github`.** The install link is personal to the
  person who asked. Whoever ran the command has to complete it, and needs permission to
  install apps on the organisation.
- **An investigation names a fix but no pull request appears.** Pull requests go
  through a Fixter review while the fix flow is in beta, so they do not arrive the
  moment the investigation finishes.

Still stuck? Email [info@fixter.dev](mailto:info@fixter.dev) and one of our founders will help you fix your problem asap.

## Related

- [Investigations](/using-fixter/investigations/): the flow this integration serves
- [Slack](/setup/slack/): where the connection is started