Setup & Integration

Setup & Integration

Connect your repositories and configure workspace tokens for proper bot attribution and team collaboration.

1

Connect Your Repositories

Add your GitHub or BitBucket repositories to start tracking pull requests and contributors.

Steps:

  1. Navigate to your repositories page
  2. Click "Add Repository"
  3. Select your GitHub or BitBucket repositories
  4. Coderbuds will automatically set up webhooks
Manage Repositories
2

BitBucket Authentication Setup

For proper bot attribution on BitBucket PR comments, configure authentication tokens. Without these tokens, comments will appear from the user associated with the repository instead of the Coderbuds bot.

1

Repository Access Token (Recommended)

Simplified

✨ New streamlined approach! Single token setup with automatic bot attribution.

  1. Go to your Repository Management page
  2. Click "Repository Token" on your BitBucket repositories
  3. Or manually: Go to repository Settings → Security → Repository access tokens
  4. Create token with Pull requests: Read, Write permissions
  5. Copy the token (starts with "ATB_") and paste it in the repository settings
  6. Done! Comments will appear with bot attribution automatically

✅ Benefits: No complex setup, immediate bot attribution, works with free BitBucket accounts

2

Workspace Access Token (For Multiple Repositories)

  1. Go to your Team SettingsBitBucket Workspace Access
  2. Follow the step-by-step instructions to create a workspace token
  3. Enter your workspace name and paste the token
  4. AI-generated comments will appear as "coderbuds-bot" for all workspace repositories

Best for: Premium BitBucket workspaces managing multiple repositories

3

Next Steps

Once you've connected your repositories and configured workspace tokens, set up deployment workflows to enable DORA metrics.

Ready for Workflows:

  • • Configure GitHub Actions or BitBucket Pipelines
  • • Enable automatic deployment tracking
  • • Start collecting DORA metrics
  • • Link pull requests to deployments automatically

GitHub Documentation

Learn more about GitHub's deployment features and best practices.

View GitHub Docs

API Integration

For advanced setups, use GitHub's REST API to create deployment events.

API Reference

Bitbucket Documentation

Learn more about Bitbucket Pipelines deployment features and configuration options.

View Bitbucket Docs