Bitbucket Integration

What it does

  • Connect Bitbucket so VDF can help with code repository management, pull request analysis, and development insights. VDF can access your Bitbucket repositories and provide intelligent code analysis and collaboration insights.

Adding the App

  1. In VDF, go to Integrations → Bitbucket → Connect.
  2. Sign in with your Bitbucket account and grant access to VDF.
  3. You'll be redirected back to VDF. Select your repositories and workspaces.
  4. Confirm the connection shows "Connected" for your selected repositories.

Usage

Prerequisites:

  • An active VDF account and Bitbucket account with repository access.
  • Recommended: Ensure you have the necessary permissions to authorize Bitbucket apps and access your repositories.

After connecting:

  • VDF can access your Bitbucket repositories and pull requests.
  • You can analyze code changes and get development insights.
  • Repository management and collaboration data becomes available.

Use in VDF (examples):

  1. Ask in chat: "Show me all open pull requests in my repository and prioritize them by importance."
  2. Ask: "Analyze the code changes in the last commit and summarize the key modifications."
  3. Ask: "Generate a development report with recent commits and their impact on the codebase."
  4. Ask: "Find all issues related to the authentication module and suggest improvements."

Removing the App

There are two parts: disconnect in VDF and remove access in Bitbucket.

  • Disconnect in VDF (stops processing immediately):

    1. In VDF, go to Integrations → Bitbucket → Disconnect.
    2. This removes your active Bitbucket authorization from VDF and stops repository access.

  • Remove access in Bitbucket (Account settings):

    1. Open your Bitbucket account → Settings → Connected Apps.
    2. Find "VDF" (or your app name) and select it.
    3. Click Remove access.

Potential implications of removal:

  • VDF will no longer be able to access your Bitbucket repositories.
  • Existing VDF artifacts (code analysis, insights) remain available until deleted per your workspace retention settings.
  • Any stored authorization tokens are revoked; future Bitbucket access is blocked.

Tips

  • Start with specific repositories if you have access to many Bitbucket workspaces.
  • Use VDF to generate comprehensive code reviews and development insights.
  • You can change your repository selection anytime in the Bitbucket integration settings.

Examples and use cases

  • Pull Request Management:
    • "Show me all open pull requests and their current status."
    • "Analyze the code changes in pull request #123 and provide feedback."
  • Code Analysis:
    • "Analyze the recent commits and identify potential issues."
    • "Generate a code quality report for the main branch."
  • Development Insights:
    • "Show me the development velocity for the last month."
    • "Identify the most active contributors and their recent work."

Prompt categories

Category Examples
Pull Request Management "Show open PRs and analyze code changes"
Code Analysis "Analyze commits and identify potential issues"
Development Insights "Show velocity and identify active contributors" 
graph LR
  B["Bitbucket Repositories"] --> V["VDF AI"]
  V --> P["Pull Request Management"]
  V --> C["Code Analysis"]
  V --> I["Development Insights"]

Troubleshooting

  • Authorization errors: Start the connection from VDF → Integrations → Bitbucket. Ensure your Bitbucket account can grant the requested permissions.
  • Repository access issues: Confirm you have the right permissions in Bitbucket and that the repositories are accessible.
  • Code access problems: Verify you have the necessary permissions to read code in the selected repositories.
  • API limitations: Some Bitbucket API endpoints may have rate limits or require additional permissions.

FAQ

  • Which Bitbucket repositories can VDF access? — VDF can access repositories where you have appropriate permissions.
  • Can I change the selected repositories? — Yes, you can update your repository selection in the integration settings.
  • What happens to my data if I disconnect? — VDF stops accessing Bitbucket. Generated artifacts in VDF remain until you delete them.
  • Do I need specific Bitbucket permissions? — Yes, you need permissions to read repositories in the selected workspaces.

Contact Support

  • Email: support@vdf.ai
  • Hours: Mon–Fri, 09:00–18:00 UTC
  • First response SLA: Within 1 business day
  • To open a case: Email us with your workspace name, Bitbucket email, and a brief description of the issue.