bb_diff_branches
Compare changes between branches in a Bitbucket repository. Displays file changes, additions, and deletions as formatted Markdown. Specify source and destination branches, and optionally limit the number of files shown. Requires configured Bitbucket credentials.
Instructions
Shows changes between branches in a repository identified by workspaceSlug and repoSlug. Compares changes in sourceBranch relative to destinationBranch. Limits the number of files to show with limit. Returns the diff as formatted Markdown showing file changes, additions, and deletions. Requires Bitbucket credentials to be configured.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Pagination cursor for retrieving additional results | |
| destinationBranch | No | Destination branch for comparison. IMPORTANT NOTE: The output displays as "destinationBranch → sourceBranch", and parameter naming can be counterintuitive. For full code diffs, try both parameter orders if initial results show only summary. If not specified, defaults to "main". Example: "develop" | |
| includeFullDiff | No | Whether to include the full code diff in the output. Defaults to true for rich output. | |
| limit | No | Maximum number of changed files to return in results | |
| repoSlug | Yes | Repository slug containing the branches. Must be a valid repository slug in the specified workspace. Example: "project-api" | |
| sourceBranch | Yes | Source branch for comparison. IMPORTANT NOTE: The output displays as "destinationBranch → sourceBranch", and parameter naming can be counterintuitive. For full code diffs, try both parameter orders if initial results show only summary. Example: "feature/login-redesign" | |
| workspaceSlug | No | Workspace slug containing the repository. If not provided, the system will use your default workspace (either configured via BITBUCKET_DEFAULT_WORKSPACE or the first workspace in your account). Example: "myteam" |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cursor": {
"description": "Pagination cursor for retrieving additional results",
"exclusiveMinimum": 0,
"type": "integer"
},
"destinationBranch": {
"description": "Destination branch for comparison. IMPORTANT NOTE: The output displays as \"destinationBranch → sourceBranch\", and parameter naming can be counterintuitive. For full code diffs, try both parameter orders if initial results show only summary. If not specified, defaults to \"main\". Example: \"develop\"",
"type": "string"
},
"includeFullDiff": {
"description": "Whether to include the full code diff in the output. Defaults to true for rich output.",
"type": "boolean"
},
"limit": {
"description": "Maximum number of changed files to return in results",
"exclusiveMinimum": 0,
"type": "integer"
},
"repoSlug": {
"description": "Repository slug containing the branches. Must be a valid repository slug in the specified workspace. Example: \"project-api\"",
"minLength": 1,
"type": "string"
},
"sourceBranch": {
"description": "Source branch for comparison. IMPORTANT NOTE: The output displays as \"destinationBranch → sourceBranch\", and parameter naming can be counterintuitive. For full code diffs, try both parameter orders if initial results show only summary. Example: \"feature/login-redesign\"",
"minLength": 1,
"type": "string"
},
"workspaceSlug": {
"description": "Workspace slug containing the repository. If not provided, the system will use your default workspace (either configured via BITBUCKET_DEFAULT_WORKSPACE or the first workspace in your account). Example: \"myteam\"",
"type": "string"
}
},
"required": [
"repoSlug",
"sourceBranch"
],
"type": "object"
}