36 lines
1.3 KiB
Plaintext
36 lines
1.3 KiB
Plaintext
---
|
|
title: "GitHub Integration"
|
|
description: "Connect to GitHub to create pull requests and manage your workflow directly from Vibe Kanban"
|
|
---
|
|
|
|
Connect your GitHub account to create pull requests and push changes directly from task attempts.
|
|
|
|
## Connect Your GitHub Account
|
|
|
|
<Frame>
|
|
<img src="/images/github-connect-settings.png" alt="Settings page with Connect GitHub Account button" />
|
|
</Frame>
|
|
|
|
Click **Connect GitHub Account** in General Settings to authenticate with GitHub using device flow authentication.
|
|
|
|
<Frame>
|
|
<img src="/images/github-device-code.png" alt="GitHub device authentication dialog with verification code" />
|
|
</Frame>
|
|
|
|
The authentication process is simple:
|
|
1. Click **Sign in with GitHub**
|
|
2. Visit the provided GitHub URL in your browser
|
|
3. Enter the device code shown in the dialog
|
|
4. Authorize Vibe Kanban in your browser
|
|
5. Return to complete the setup
|
|
|
|
**Required Permissions**: Vibe Kanban needs access to your repositories (`repo`), basic profile info (`read:user`), and email address (`user:email`) for Git commits.
|
|
|
|
<Note>
|
|
If you encounter permission issues when creating pull requests, you'll be prompted to provide a Personal Access Token as a fallback authentication method.
|
|
</Note>
|
|
|
|
## Related Documentation
|
|
|
|
- [Completing a Task](/core-features/completing-a-task) - Learn how to create pull requests and manage branches
|