New advertisers: 50% off your first month with code FIRSTMONTHSee slots
agentworkforce avatar

Github Oauth Nango Integration

Two-connection pattern that links GitHub login identity to GitHub App repo access through Nango webhooks.

GitHub stars
1.1K
last updated
Jun 11, 2026
View on GitHub

What it does

  • Covers dual-connection GitHub auth: a github login integration for identity and a github-app-oauth integration for repo access
  • Stores login and repo connection IDs in users and repos tables, with installations tracked in github_installations
  • Handles Nango auth webhooks by routing each connection to its integration-specific handler, including duplicate-connection cleanup
  • Designed for apps that need both GitHub user sign-in and granular repository permissions through GitHub App installations

Install

$ npx -y skills add agentworkforce/relay --skill github-oauth-nango-integration -y

Installs into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.

Files

GitHub OAuth + Nango Integration

Overview

Implements dual-connection OAuth pattern: one for user identity (github integration), another for repository access (github-app-oauth integration). This separation enables secure login while maintaining granular repo permissions through GitHub App installations.

When to Use

  • Setting up GitHub OAuth login via Nango
  • Implementing GitHub App installation webhooks
  • Reconciling OAuth users with GitHub App installations
  • Building apps that need both user auth and repo access
  • Handling Nango sync webhooks for GitHub data

Why Two Connections?

GitHub has two different authentication mechanisms that serve different purposes:

GitHub OAuth App (github integration)

  • What it is: Traditional OAuth for user identity
  • What it gives you: User profile (name, email, avatar, GitHub ID)
  • What it DOESN'T give you: Access to repositories
  • Use for: Login, "Sign in with GitHub"

GitHub App (github-app-oauth integration)

Details

Repository
github.com/agentworkforce/relay
Categories
Security, Git & Pull Requests
License
Apache-2.0
First seen
Jun 11, 2026

More from agentworkforce/relay

All 17

Similar to Github Oauth Nango Integration

More Security