GitHub Integration

BambooSnow provides deep integration with GitHub, enabling AI-powered automation across your development workflow.

Features

• Repository access - Connect public and private repositories
• Pull request integration - Comment, review, and approve PRs
• Webhook events - React to repository events in real-time
• GitHub Actions - Integrate with your CI/CD pipelines
• GitHub Checks - Report agent status as check runs

Setting Up

Step 1: Install the GitHub App

1. Go to Settings > Integrations > GitHub
2. Click Install GitHub App
3. Select the repositories to connect
4. Authorize the requested permissions

Step 2: Configure Permissions

The BambooSnow GitHub App requests:

| Permission | Level | Purpose | |------------|-------|---------| | Repository contents | Read & Write | Analyze code, create PRs | | Pull requests | Read & Write | Comment, review, merge | | Checks | Read & Write | Report agent status | | Webhooks | Read & Write | Receive events | | Metadata | Read | Repository information |

Step 3: Verify Connection

After installation:

1. Go to Repositories in BambooSnow
2. Click Refresh to see connected repositories
3. Verify your repositories appear in the list

Pull Request Integration

Automated Reviews

Agents can post reviews on pull requests:

agents:
  - name: code-reviewer
    config:
      review_type: request_changes  # or 'approve', 'comment'
      post_as: review  # or 'comment', 'check'

Status Checks

Report agent status as GitHub checks:

agents:
  - name: security-scanner
    config:
      github_check:
        name: "Security Scan"
        title: "BambooSnow Security Scanner"
        conclusion_on_issues: failure  # or 'neutral', 'success'

PR Labels

Automatically add labels based on agent findings:

config:
  labels:
    on_success: ["ai-approved"]
    on_failure: ["needs-attention"]
    on_security_issue: ["security"]

Webhook Events

BambooSnow listens for these GitHub events:

| Event | Trigger | |-------|---------| | pull_request | PR opened, updated, closed | | push | Code pushed to branches | | issue_comment | Comments on issues/PRs | | check_run | Check status changes | | workflow_run | GitHub Actions workflow events |

Custom Event Handling

React to specific events:

triggers:
  github_event:
    types:
      - issue_comment
    filters:
      body_contains: "@bamboosnow review"

GitHub Actions Integration

Use BambooSnow in your GitHub Actions workflows:

# .github/workflows/bamboosnow.yml
name: BambooSnow Analysis

on:
  pull_request:
    branches: [main]

jobs:
  analyze:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Run BambooSnow Analysis
        uses: bamboosnow/action@v1
        with:
          api_key: ${{ secrets.BAMBOOSNOW_API_KEY }}
          agents:
            - code-reviewer
            - security-scanner

Branch Protection

Configure agents as required status checks:

1. Go to repository Settings > Branches
2. Edit branch protection rule
3. Under "Require status checks", add:
   • "BambooSnow / Code Review"
   • "BambooSnow / Security Scan"

Enterprise GitHub

For GitHub Enterprise Server:

# .bamboosnow/config.yml
github:
  type: enterprise
  url: https://github.your-company.com
  api_url: https://github.your-company.com/api/v3

Troubleshooting

"Repository not found"

• Verify the GitHub App is installed on the repository
• Check organization access settings
• Ensure you have admin access

"Permission denied"

• Re-authorize the GitHub App
• Check if permissions were reduced
• Verify organization policies

"Webhooks not receiving"

• Check webhook delivery in GitHub settings
• Verify the webhook URL is correct
• Check for firewall/network issues