GitHub Integration
Connect your GitHub account, link repositories to projects, and let AI push code directly as Pull Requests.
How to Connect GitHub
Go to AI Integrations
From your dashboard, navigate to AI Integrations in the sidebar. You'll see the GitHub connection section at the top.
Authorize with GitHub
Click "Connect GitHub". You'll be redirected to GitHub to authorize the app. We request repo and user:email scopes to clone repos, push branches, and create Pull Requests.
Link a Repo to Your Project
Open any project and click "Link GitHub Repo". A dropdown shows all your repositories. Each project can be linked to one repo.
AI Pushes Code to Your Repo
When a task is executed by AI, the worker clones the repo, creates a branch, writes code, and opens a Pull Request. Move 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.
