Connecting Your Repository

Learn how to connect your GitHub repositories to BambooSnow and configure access permissions.

Supported Platforms

Currently, BambooSnow supports:

GitHub - Full support for public and private repositories
GitHub Enterprise - Available on Team and Enterprise plans

Required Permissions

When you connect a repository, BambooSnow requests the following permissions:

| Permission | Purpose | |------------|---------| | repo | Read code and create pull requests | | pull_requests | Comment on and review PRs | | checks | Report agent status | | webhooks | Receive events when PRs are created |

Connecting a Repository

Step 1: Navigate to Repositories

From your dashboard, click Repositories in the sidebar, then click Add Repository.

Step 2: Select Repository

You'll see a list of repositories you have access to. Use the search bar to find specific repos. Click on the repository you want to connect.

Step 3: Configure Settings

Choose your connection settings:

Branch to monitor: The primary branch agents will analyze (default: main)
Auto-analyze: Automatically run analysis when code is pushed
PR triggers: Which pull request events should trigger agents

Step 4: Confirm Connection

Review your settings and click Connect Repository. BambooSnow will:

Install the GitHub App on your repository
Run an initial code analysis
Set up webhooks for event monitoring

Managing Connected Repositories

Viewing Repository Status

Each connected repository shows:

Last analyzed: When the repository was last scanned
Active agents: Number of agents deployed
Recent activity: Latest agent runs and their status

Disconnecting a Repository

To disconnect a repository:

Go to Repositories > Select the repository
Click Settings > Disconnect
Confirm the disconnection

This will:

Remove all agents from the repository
Delete the webhook
Keep your historical data for 30 days

Organization Repositories

For organization repositories, you may need additional approval:

An organization admin must approve the BambooSnow GitHub App
Go to your organization's GitHub settings
Navigate to Third-party access > GitHub Apps
Find BambooSnow and click Configure

Troubleshooting

"Repository not appearing"

Ensure you have admin access to the repository
Check if the repository is archived
Try refreshing the repository list

"Permission denied"

Re-authorize BambooSnow in GitHub settings
Ensure the GitHub App is installed on the repository
Check organization access policies