GitHub Integration

Connect GitHub to automatically ingest PRs and issues.

The GitHub connector automatically extracts knowledge from merged PRs, issues, and comments.

Setup

1. Install the GitHub App

  1. Navigate to Connectors in the Cortex dashboard
  2. Click Connect GitHub
  3. Authorize the Cortex GitHub App
  4. Select repositories to monitor

2. Configure Webhooks

Cortex receives events via GitHub webhooks. The endpoint is:

POST /api/webhooks/github

3. Event Processing

EventAction
pull_request.closedIngest PR summary and decisions
issue.closedIngest issue resolution
issue_commentIngest discussion context

What Gets Ingested

When a PR is merged, Cortex extracts:

  • Title and description — What changed
  • Decisions — Why it changed
  • Files affected — What was modified
  • Discussion — Key comments and reviews

Scope Assignment

GitHub-sourced memories are automatically assigned to the engineering scope by default.

You can override this per-PR by including a tag in the description:

## Summary
Added rate limiting to /api/users.

@cortex:scope=security

Disabling

To disable the GitHub connector:

  1. Navigate to Connectors in the dashboard
  2. Find GitHub
  3. Click Disconnect

Disconnecting the GitHub connector stops new ingestions but does not delete existing memories.