Connect GitHub

Create the token

GitHub calls its keys “personal access tokens”. The fine-grained kind is best: you decide exactly which repositories it can see and what it may do with them.

• GitHub → your avatar → Settings → Developer settings → Personal access tokens → Fine-grained tokens (or visit github.com/settings/tokens).
• Click “Generate new token”, name it “Cortex”, and pick an expiry you are comfortable renewing.
• Under “Repository access”, choose the repositories your AIs should reach.
• Copy the token when it is shown — that is the only time GitHub displays it.

Permissions

• Contents: Read-only lets AIs browse code and files; Read and write lets them commit.
• Issues and Pull requests: Read and write if you want AIs to open or comment on them, Read-only otherwise.
• Grant only what you will actually use — you can always create a new token with more later.

Paste it into Cortex

• Connect AI page → Connected tools → “Connect a tool” → pick GitHub.
• Paste the token into the “Personal access token” field and click Connect.

Confirm it worked

The connection test reports a tool count on success. Ask a connected AI to “list open issues in <your repo>” to see it live.