Wiki · AI connections
Connect Gitea
Your self-hosted Git — repos, issues and releases — as AI tools.
Create the access token
- Sign in to your Gitea and go to your avatar → Settings → Applications.
- Under “Manage Access Tokens”, name the token “Cortex”.
- Select the scopes (see below), click “Generate Token”, and copy it right away — it is shown once.
Scopes
- repository: read for browsing code, read/write if AIs should push or edit.
- issue: read/write to let AIs read and open issues and pull requests.
- Skip admin and organization scopes — the connector never needs them.
Paste it into Cortex
Gitea is self-hosted, so Cortex needs your instance’s API address too.
- Connect AI page → Connected tools → “Connect a tool” → pick Gitea.
- Enter your instance’s API URL: your normal Gitea address with /api/v1 appended, e.g. https://git.example.com/api/v1.
- Paste the token and click Connect. Cortex sends it in Gitea’s own “token …” format automatically.
- On a LAN or VPN address? Tick “Allow private network” first.
Confirm it worked
A green tool count means the token and URL are right. Then ask a connected AI to “list my Gitea repositories”.