Connect GitHub

Code needs a repository to work on. You give it one by connecting GitHub from the product; Cortex then lists the repositories the grant covers and starts sessions on them. The same connection adds GitHub tools to Chat.

Connect

A guest cannot hold a GitHub grant — there would be no way to come back and revoke it.

Choose Connect GitHub

From Code Home, the repository picker, or Settings → Integrations.

Approve on GitHub

Grant access to the repositories you want Code to see. There is no personal-access-token field anywhere in Cortex; the connection is the only route.

Pick a repository

Back in Code, choose a repository and start a session. See Sessions.

What the connection gives you

Surface	What GitHub adds
Code	The repository list; sessions clone and work inside the guest
Chat	Four GitHub tools — list pull requests, list issues, create an issue, and more — available in your conversations
CLI	`cortex pr <number>` to check out a pull request, and `cortex github install` to scaffold review workflows. See Headless runs

If something is missing

What you see	What it means	Do this
No Connect control	GitHub is not available on this deployment	Nothing to configure — the surface is not offered here
Reconnect	The grant lapsed or was revoked on GitHub	Choose Reconnect and approve again
The public `/code` page instead of Code Home	You are not signed in	Sign in
A repository is not listed	The grant does not cover it	Reconnect and include it, or adjust the installation on GitHub

Three different GitHub installs

Install	Purpose	Where
Connect GitHub	Repositories for Code sessions; GitHub tools in Chat	Code Home, repository picker, Settings → Integrations
Cortex Security GitHub App	Pull-request review as a check run	`/code/security` in the app — see Cortex Security
`cortex github install`	Workflow files for CI review from the CLI	Your repository — see Headless runs

Connect GitHub is not part of Chat’s connector catalogue under Customize, and Code Cloud is not a plugin surface.

Code quickstart
Tools and connectors — the rest of Chat’s connections.
Troubleshooting

⌘I

Getting started

Core guides

Desktop and terminal

Advanced

Connect

What the connection gives you

If something is missing

Three different GitHub installs

​Connect

​What the connection gives you

​If something is missing

​Three different GitHub installs

​Related

Connect

What the connection gives you

If something is missing

Three different GitHub installs

Related