Integration Guide

GitHub

Connect your GitHub account to link repositories and let AI push code directly as Pull Requests.

About GitHub Integration

GitHub integration is essential for Vibe Coding Plan's autonomous task execution. When connected, AI agents can clone your repository, create feature branches, write code, and open Pull Requests — all automatically. You review the PR on GitHub and merge when ready.

Required for task execution OAuth connection Auto Pull Requests

How to Connect GitHub

1

Go to AI Integrations

Log in to Vibe Coding Plan and navigate to AI Integrations from the sidebar. You'll see the GitHub connection section under "Development Tools" at the top.

2

Click "Connect GitHub"

Click the "Connect GitHub" button. You'll be redirected to GitHub's authorization page where you grant Vibe Coding Plan access to your repositories.

3

Authorize the App

On GitHub, review the requested permissions and click "Authorize". We request repo and user:email scopes to clone repos, push branches, and create Pull Requests on your behalf.

4

Link a Repository to a Project

Open any project in Vibe Coding Plan and click "Link GitHub Repo". A dropdown shows all your repositories. Select the one you want to connect — each project can be linked to one repo.

5

AI Pushes Code Automatically

When a task is executed by AI, the worker clones your repo, creates a branch named task/{id}-{slug}, writes code, and opens a Pull Request. Move the task to "Completed" to auto-merge.

What Happens Behind the Scenes

Cloning: The worker clones your repository into a secure workspace. Consecutive tasks reuse the workspace to save time.

Branching: Each task gets its own branch named task/{id}-{slug}, based on your default branch.

Pull Requests: After coding, a PR is created with a descriptive title and summary. Review the diff on GitHub like any normal PR.

Auto-Merge: Moving a task to "Completed" on the Kanban board sends a merge request via the GitHub API into your default branch.

Empty Repos: If your repo is empty (no commits), the system creates an initial commit on main before creating task branches.

Permissions & Security

OAuth scopes: We request repo (full repository access) and user:email (to identify your account).

Token storage: Your GitHub OAuth token is encrypted and stored securely. It is never exposed in logs or to other users.

Revoke anytime: You can disconnect GitHub from AI Integrations or revoke access directly from GitHub Settings → Applications.

Private repos: The integration works with both public and private repositories. Only you can link repos to your projects.