GitHub Integration

Install the Capy GitHub App to connect repositories, manage branches automatically, and create pull requests from AI-generated code changes.

Connecting GitHub

Install the Capy GitHub App from the dashboard by clicking Connect GitHub, then choose which repositories to grant access to. You can update repo access anytime in your GitHub settings.

Working with repos

Repositories are cloned automatically when a task starts. Capy creates a branch (capy/<task-slug>-<id>) for each task - your main branch stays clean. When you’re happy with the changes, click Create PR in the diff view and merge on GitHub.

You can set the default branch for each repo (e.g., main, develop) from the dashboard.

Permissions

Permission	Purpose
Contents	Read/write code
Pull requests	Create PRs
Issues	Read for context
Metadata	Repo info

Troubleshooting

Repo not appearing

Check that the GitHub App is installed and you’ve selected the repo in your GitHub settings. You may need to re-authorize if you recently changed org permissions.

Push failed

Make sure you’re on a working branch (capy/*). Capy never pushes directly to your default branch.