Skip to main content

​
Bitbucket

Shanone’s Bitbucket integration gives your agent 15 tools covering the everyday code-review workflow — repositories and branches, pull requests, issues, and code search.

​
Getting Started

1

Connect via OAuth

Ask your agent to do something with Bitbucket (e.g. “list open pull requests in my-workspace/my-repo”), or connect proactively from Integrations in the Shanone dashboard.
2

Authorize the requested scopes

Approve Bitbucket’s OAuth consent screen for the workspaces and repositories you want Shanone to access.
3

Retry your request

Once connected, shanone_execute_tool calls for bitbucket_* tools will succeed.

​
Available Tools

Shanone provides 15 tools for Bitbucket, organized into these categories:
bitbucket_list_pull_requests, bitbucket_get_pull_request, bitbucket_create_pull_request, bitbucket_create_pull_request_comment
bitbucket_list_issues, bitbucket_get_issue, bitbucket_create_issue, bitbucket_create_issue_comment
bitbucket_list_repositories, bitbucket_get_repository, bitbucket_list_branches, bitbucket_list_commits
bitbucket_search_code
bitbucket_get_current_user, bitbucket_list_workspaces

​
Common Use Cases

PR review triage

List open pull requests across a repo and comment on ones that need attention

Cross-repo code search

Search for a function or string usage across repositories in a workspace

Issue backlog grooming

List and comment on open issues to keep a backlog current

Branch/commit auditing

List branches and recent commits to check what’s diverged from main before merging

​
Troubleshooting

Results are scoped to the workspace(s) authorized during OAuth. Call bitbucket_list_workspaces to confirm which workspaces are connected, and reconnect if a workspace is missing.
Bitbucket’s code search indexes asynchronously after pushes — very recent commits may not be searchable yet. Try bitbucket_list_commits on the specific branch instead if you need up-to-the-minute results.
Confirm the source and destination branch names with bitbucket_list_branches first — Bitbucket requires both branches to already exist in the repository.