Skip to main content
Connect your CatDoes project to a GitHub repository. Once connected, AI agents can read your existing code, make changes, commit them, and push updates to your repository — all while maintaining full git history.
GitHub integration requires an active paid subscription.

​
Connecting Your Repository

  1. From your project dashboard, click Connect GitHub.
  2. On GitHub, authorize the CatDoes app and select which repositories to grant access to.
  3. Back on CatDoes, select the repository you want to link from the dropdown.
  4. Choose the branch you want to work with (defaults to your repository’s default branch).
  5. Click Link Repository.
Your GitHub integration is now active. AI agents can now read, modify, and push code to the selected branch.

​
Working with Branches

You can switch branches or create new ones directly from your project dashboard. To switch branches:
  1. Click Change next to your connected repository
  2. Select a different branch
  3. Click Update
To create a new branch:
  1. In the branch dropdown, click Create New Branch
  2. Enter a branch name (like feature/new-feature or fix/bug-name)
  3. Optionally select which branch to create it from
  4. Click Create
The new branch is created on GitHub and immediately available for use.

​
How AI Uses GitHub

When you ask an AI agent to make changes:
  1. The agent reads your existing code from the connected repository
  2. Makes the requested modifications
  3. Commits the changes with a descriptive message
  4. Pushes to your selected branch
All changes are tracked in your git history, just like regular commits. The agent can also:
  • Pull the latest changes from GitHub before making modifications
  • Handle merge conflicts if they arise
  • Reset to the remote state if needed

​
Changing or Disconnecting

To change repository or branch:
  1. Go to your project dashboard
  2. Click Change on the GitHub Integration card
  3. Select a new repository and/or branch
  4. Click Update
To disconnect:
  1. Go to your project dashboard
  2. Click Disconnect on the GitHub Integration card
Disconnecting removes the link but doesn’t affect your repository on GitHub.

​
Tips

Work on feature branches instead of main. This keeps your main branch stable while letting the AI experiment on separate branches.
Review AI commits on GitHub after they’re made. Check the diff to see exactly what changed and why.