Connect GitHub
Link your GitHub account and install the Paragon app to enable PR reviews, agent sessions, and automations.
GitHub is required for Paragon to access your repositories, review pull requests, and make code changes through the agent. Connection has two parts: authenticating your account and installing the GitHub App.
1. Sign in with GitHub
- Go to app.paragon.run
- Click Sign in with GitHub
- Authorize Paragon to access your GitHub account
This grants Paragon read access to your user profile, email, and organizations.
2. Install the GitHub App
After signing in, you'll be prompted to install the Paragon GitHub App:
- Click Connect on the setup screen, or go to Settings and click Connect under Code Host Connections — this takes you to the Paragon GitHub App install page
- Select your GitHub account or organization
- Choose which repositories to grant access to — you can select all or pick specific repos
- Click Install
You can change which repositories the app has access to at any time from your GitHub App settings.
What GitHub enables
| Feature | Description |
|---|---|
| PR Reviews | Automatic code reviews on pull requests with inline comments and suggestions |
| Agent Sessions | Trigger the agent by mentioning @paragon-run in issues, PRs, or review comments |
| Pull Requests | The agent commits changes and opens PRs directly in your repos |
| Automations | Trigger automations on PR created, PR merged, push, comments, and reviews |
| Repository Sync | Import repos for testing, wiki generation, and monitoring |
Managing your connection
Go to Settings in the dashboard to view your GitHub connection status, reconnect, or modify repository access.
Next steps
Connect Slack
Add Slack for agent triggering, notifications, and plan approvals.
Agent Integrations
Configure GitHub mentions, Slack triggers, and MCP services.