Integrations

GitHub

Connect GitHub to pull recent deployments, commits, and PR history as investigation context.

Register the OAuth App

1
Go to GitHub developer settings
Navigate to github.com/settings/developers → OAuth Apps → New OAuth App
2
Fill in the details
Name: Seren
Homepage URL: http://localhost:3000
Authorization callback URL: http://localhost:3000/integrations/callback/github
3
Copy credentials
Save CLIENT_ID and CLIENT_SECRET to your .env file.

Dev vs Prod

GitHub only allows one callback URL per OAuth app. Create two separate apps:

env
# Development app
GITHUB_CLIENT_ID=dev_id
GITHUB_CLIENT_SECRET=dev_secret
# Callback: http://localhost:3000/integrations/callback/github

# Production app
GITHUB_CLIENT_ID=prod_id
GITHUB_CLIENT_SECRET=prod_secret
# Callback: https://yourdomain.com/integrations/callback/github
Device Flow
Leave "Allow this OAuth App to authorize users via the Device Flow" unchecked. Seren is a web app — Device Flow is for CLI tools and headless environments only.

Required Scopes

scopes
repo
read:org