CEO.ai

GitHub Integration Setup

Connect CEO.ai to Your GitHub Account

Integrating GitHub with CEO.ai enables automatic code deployment from your AI-generated projects directly to your repositories. Every multi-task project you create will have its outputs committed and pushed to a dedicated GitHub repository—no manual copying, no missed files, just seamless deployment.

Why Integrate GitHub?

When you run a multi-task project in CEO.ai, the platform generates complete codebases with multiple files, components, and configurations. The GitHub integration:

  • Automatically creates a new repository for each project
  • Commits all project outputs as they're generated
  • Maintains a complete commit history of the development process
  • Names repositories using your project's workflow ID for easy tracking

Watch your AI team's work flow directly into version control, ready for review, collaboration, and deployment.

Setup Instructions

Step 1: Navigate to Integration Settings

Access the Integration Settings page using either method:

Step 2: View Your Integrations

On the Integration Settings page, you'll see:

  • Active Integrations: All currently connected services
  • Add New Integration dropdown: Create new connections

Note: GitHub is currently the only supported integration, with more services coming soon.

Step 3: Start GitHub Integration

  1. Click the Add New Integration dropdown
  2. Select GitHub from the options

Step 4: Create a GitHub Personal Access Token

Before you can connect, you need to generate an access token from your GitHub account. This token allows CEO.ai to create repositories and push code on your behalf.

  1. Click on your profile picture in the top right corner of GitHub
  2. Select Settings from the dropdown menu
  3. Scroll down and click Developer settings (in the left sidebar)
  4. Click Personal access tokens

Choose Token Type

You can create either a Classic token or Fine-grained token. Choose based on your security preferences:

Option A: Classic Token (Simpler setup)
  • Click Tokens (classic) → Generate new token (classic)
  • Select the following scopes:
    • ✅ repo (minimum required - full control of private repositories)
    • ✅ workflow (recommended - update GitHub Action workflows)
  • Set an expiration date
  • Click Generate token
Option B: Fine-grained Token (More granular control)
  • Click Fine-grained tokens → Generate new token
  • Configure the following permissions:
    • Repository access: Select "All repositories"
    • Repository permissions:
      • • Administration: Read and write
      • • Contents: Read and write
      • • Pull requests: Read and write
      • • Metadata: Read-only (automatically included)
  • Set an expiration date
  • Click Generate token

Copy Your Token

⚠️ Important: Copy your token immediately. GitHub only displays it once for security reasons. If you lose it, you'll need to generate a new one.

Step 5: Connect Your Token to CEO.ai

  1. Return to the Integration Settings page in CEO.ai
  2. Paste your GitHub access token into the form field
  3. Click Connect GitHub

Security Note: Your token is encrypted before transmission and stored only in encrypted form on our backend. CEO.ai never stores or transmits your token in plain text.

Step 6: Verify Your Connection

Once connected successfully, you'll see a new integration card displaying:

  • Service: GitHub logo
  • Username: Your GitHub profile picture and username/handle
  • Connector ID: Unique identifier for this connection
  • Status: Active (with green indicator)
  • Date & Time: When the connection was established

How It Works

Automatic Repository Creation

When you start a multi-task project workflow:

  1. Repository Created: CEO.ai automatically creates a new GitHub repository named after your project's workflow ID
  2. Sequential Commits: As each agent completes their task, outputs are committed to the repository
  3. Complete History: Every step is tracked in the commit history, showing the progression of your project

Monitoring Your Deployment

During project execution, you can:

  • Visit your GitHub account to see the repository appear
  • Watch commits being added in real-time as agents complete tasks
  • Review the complete codebase once the workflow finishes

All of this happens automatically—you don't need to take any action after connecting your integration.

Troubleshooting

Connection Failed

  • Verify token permissions: Ensure your token has the required scopes
  • Check token expiration: Expired tokens need to be regenerated
  • Confirm token copied correctly: Extra spaces or missing characters will cause failures

Repository Not Created

  • Check workflow status: The repository is only created when a multi-task project runs
  • Verify integration is active: Check your Integration Settings page shows "Active" status
  • Review GitHub permissions: Your account must have permission to create repositories

Commits Not Appearing

  • Wait for task completion: Commits happen sequentially as each agent finishes their work
  • Check GitHub rate limits: In rare cases, GitHub API limits may delay commits
  • Verify repository permissions: Ensure the created repository allows write access

Managing Your Integration

Updating Your Token

If your token expires or you need to change permissions:

  1. Generate a new token in GitHub (following Step 4)
  2. Return to Integration Settings
  3. Remove the existing integration
  4. Add a new GitHub integration with your new token

Removing the Integration

To disconnect GitHub:

  1. Navigate to Integration Settings
  2. Find your GitHub integration card
  3. Click the remove/disconnect option
  4. Confirm removal

Note: Removing the integration won't delete existing repositories, but new projects won't automatically push to GitHub.

Next Steps

Now that your GitHub integration is configured:

Create Your First Multi-Task Project

Put your integration to work

Understanding Project Workflows

Learn how CEO.ai builds complete projects

Repository Management Best Practices

Organize your AI-generated codebases

Questions? Check our FAQ or reach out to support for assistance with your GitHub integration.