Connect GitHub and enable PR Cost Attribution

PR Cost Attribution combines two data sources:

1. GitHub supplies repositories, commits, and pull requests.
2. SuperPenguin Desktop supplies each engineer's local AI coding activity.

When both are available, SuperPenguin can associate AI coding cost with the pull request that produced it.

PR Cost Attribution requires:

1. A workspace with PR attribution enabled. Free includes 3 merged PRs total, Growth includes the latest 20 merged PRs this month, and Pro includes unlimited PRs.
2. Desktop reporting from the engineers whose work should be attributed.
3. A GitHub connection.

Cursor billing is optional. It adds provider-billed Cursor dollars, but Claude Code and Codex PR attribution do not require Cursor, Anthropic, or OpenAI billing connections.

Connect GitHub

1. Open Integrations.
2. Find GitHub.
3. Select Install GitHub App.
4. Sign in to GitHub if asked.
5. Choose the GitHub organization.
6. Select the repositories SuperPenguin may access.
7. Return to SuperPenguin and confirm the connection.

Installing the GitHub App for an organization must be completed or approved by a GitHub organization owner or administrator. The GitHub App is the recommended connection method because it avoids managing a personal token.

SuperPenguin automatically syncs the repository and pull-request metadata shared by the installation.

Connect with a personal token

If you use a personal access token, you do not need to type an organization or repository name:

1. Enter a fine-grained GitHub token with Pull requests and Contents read access for the repositories you want to connect.
2. Select Load repositories. This reads the repository list without saving the token or starting a sync.
3. Search the list and check the repositories you want to sync. Use Load more repositories if more are available.
4. Select Connect selected repositories. At least one repository must be selected.

To change an existing token connection, select Choose repositories. SuperPenguin uses the saved token, so you do not need to paste it again. Only selected repositories are synced; previously synced data is retained.

If a repository is missing, check the token's repository access and any required organization approval or SSO authorization in GitHub.

Connect every engineer

GitHub data alone does not include local AI coding activity. Each engineer must also install SuperPenguin Desktop, sign in, and select the company workspace.

The PR Costs setup panel marks these steps complete when:

• The workspace has PR attribution enabled and the PR is within its plan allowance.
• The workspace has a supported Desktop reporting signal.
• The workspace has a GitHub integration.

The panel also offers Cursor billing as an optional step. It does not block PR Costs completion.

GitHub is required only for PR Costs. The AI Coding dashboard can report Claude Code and Codex activity after the plan and Desktop steps are complete without GitHub.

Visibility

Workspace owners and members with organization-wide AI Coding access can view aggregate PR Cost Attribution. Ordinary members remain self-scoped.

See Workspace roles and AI Coding visibility for access details.

If setup is incomplete

• If GitHub is disconnected, reconnect it from Integrations.
• If repositories are missing, review the GitHub App repository selection.
• If an engineer has no activity, confirm Desktop is installed, signed in, and using the correct workspace.
• If the feature is locked, review Plans and entitlements.

See Set up AI Coding and PR Costs for the shared checklist and optional provider connections.