How do I connect GitHub to codus?

Open Integrations in settings, find the GitHub card under Source control, and click Connect GitHub. Your browser opens a GitHub page, you enter the short code the card shows you, and you approve access. When you come back, the card reads "Connected as @yourname". Once connected, codus can list and check out the open pull requests for the repo you are working in, shown in the Pull requests panel.

Before you start

• You need a GitHub account and access to the repository you want to work with.
• The connection is a browser sign-in, so you approve it on github.com. There is nothing to paste.

Steps

1. Open the gear (⚙), click See all settings →, then click Integrations.
2. Find the GitHub card and click Connect GitHub.
3. Your browser opens a GitHub device page, and the codus card shows a short code with the line "Browser opened. Enter this code in the GitHub page that just loaded:".
4. In the browser, sign in to GitHub if asked, type or paste the code, and click through to authorize codus.
5. Come back to codus. The card moves from "Waiting for authorization…" to "Connected as @yourname" on its own.

How do I know it worked?

The card shows a green Connected as @yourname label using your GitHub username. From then on, when you open the Pull requests panel for a GitHub repo, codus can list the open pull requests and check one out for you.

Common problems

• The code expired before I finished. The card stops waiting after a while. Click Cancel, then Connect GitHub again for a fresh code.
• I approved in the browser but the card still says waiting. Bring codus back to the front. The card re-checks when the window regains focus, so it should flip to Connected within a moment.
• I want to disconnect. Click Disconnect on the card and confirm. codus warns "You will need to re-authorize via the browser to see pull requests again." To reconnect, click Connect GitHub and approve once more.