GitHub Integration

Connect your CatDoes project to a GitHub repository. Once connected, AI agents can read your existing code, make changes, and push updates to your repository — all while maintaining full git history.

​

Connecting Your Repository

1. Open your project’s overview page and find the GitHub card under Services.
2. Click Connect to GitHub.
3. On GitHub, authorize the CatDoes app and select which repositories to grant access to.
4. Back on CatDoes, select the Repository you want to link from the dropdown.
5. Choose the Branch you want to work with (defaults to your repository’s default branch).
6. Click Save.

Your GitHub integration is now active, and the card shows a Linked badge. AI agents can now read, modify, and push code to the selected branch.

​

Working with Branches

You can switch branches or create new ones from the GitHub card. To switch branches:

1. Click Change on the GitHub card
2. Select a different branch
3. Click Save

To create a new branch:

1. In the branch dropdown, click New Branch
2. Enter a branch name (like feature/new-feature or fix/bug-name)
3. Click Create Branch

The new branch is created on GitHub from your default branch and is immediately available for use.

​

How AI Uses GitHub

To send your latest changes to GitHub, just ask the agent — for example, “Push my changes to GitHub.” The agent:

1. Collects the changes you’ve made in CatDoes
2. Commits them with a descriptive message
3. Pushes them to your selected branch

All changes are tracked in your git history, just like regular commits. Private files like your .env are never uploaded. The agent can also:

• Pull the latest changes from GitHub when you ask
• Handle merge conflicts if they arise
• Cancel a pull and go back to how things were before

Before doing anything that would overwrite your work — like replacing your files with what’s on GitHub — the agent asks for your approval first.

​

Sync Status

The GitHub card shows whether your project and your repository match: Sync status isn’t shown on some older projects yet.

​

Changing or Disconnecting

To change repository or branch:

1. Go to your project’s overview page
2. Click Change on the GitHub card
3. Select a new repository and/or branch
4. Click Save

To disconnect:

1. Go to your project’s overview page
2. Click Disconnect on the GitHub card, then click Confirm disconnect

Disconnecting removes the link but doesn’t affect your repository on GitHub.

​

Tips