GitHub Integration

Sidekick's GitHub integration connects your AI agent to your development workflow. Once connected, your agent can monitor repositories, triage issues, review pull requests, and track CI status — across personal accounts and organizations.

What your agent can do

Capability	Details
Monitor repositories	Watch for pushes, releases, and CI status changes
Triage issues	Categorize, label, prioritize, and draft responses to incoming issues
Review pull requests	Surface PRs needing attention, suggest reviewers, summarize diffs
Track CI status	Get notified of pipeline failures and status changes
Handle notifications	Consolidate and act on GitHub notifications alongside your other connected services

Connecting GitHub

1. Go to Integrations in your Sidekick dashboard.
2. Find GitHub and click Connect.
3. Authorize Sidekick via GitHub OAuth. You can grant access to your personal account, specific organizations, or both.
4. Select the repositories you want your agent to monitor.
5. Click Save. Your agent will begin monitoring immediately.

Note: Sidekick uses GitHub's OAuth app flow. No personal access tokens or API keys are required.

Repository Monitoring

After connecting, your agent passively monitors selected repos for:

• New commits and pushes
• Release publications
• CI/CD pipeline status changes (pass, fail, pending)

CI status updates are surfaced in your Sidekick activity feed and can trigger autonomous actions you configure (e.g. notify on failure, re-run flaky tests).

Issue Triage

Your agent can process incoming issues as they are filed:

• Categorize issues by type (bug, feature request, question, etc.)
• Label issues based on content analysis
• Prioritize by severity or user impact
• Draft responses for common or known issues

You can review and approve agent-drafted responses before they are posted, or configure the agent to act autonomously.

Pull Request Management

Your agent monitors open pull requests and can:

• Identify PRs that are stale, blocked, or awaiting review
• Suggest appropriate reviewers based on code ownership and history
• Summarize PR diffs on request
• Respond to PR-related notifications from the Sidekick dashboard

Notification Handling

GitHub notifications are pulled into Sidekick's unified notification feed alongside email, chat, and other connected services. Your agent can:

• Mark notifications as read
• Dismiss or snooze low-priority alerts
• Escalate critical items (e.g. security alerts, failing CI on main)

Organizations & Multiple Repos

The GitHub integration supports:

• Multiple repositories — personal and organization repos can be added together
• GitHub Organizations — authorize at the org level to monitor all repos your account has access to
• Cross-repo views — issues, PRs, and CI status are aggregated in a single Sidekick view regardless of how many repos are connected

Permissions

Sidekick requests the following GitHub OAuth scopes:

Scope	Reason
repo	Read and write access to repositories, issues, and pull requests
notifications	Read and manage your GitHub notifications
read:org	Read organization membership for org-level repo access

You can revoke access at any time from GitHub → Settings → Applications or from the Sidekick Integrations page.