bb_ls_repos
Quickly list and filter repositories in a Bitbucket workspace by name, project key, user role, or query string. Supports sorting, pagination, and returns detailed Markdown-formatted results for easy integration and analysis. Requires Bitbucket credentials for access.
Instructions
Lists repositories within a workspace. If workspaceSlug is not provided, uses your default workspace (either configured via BITBUCKET_DEFAULT_WORKSPACE or the first workspace in your account). Filters repositories by the users role, project key projectKey, or a querystring (searches name/description). Supports sorting viasortand pagination vialimitandcursor`. Pagination details are included at the end of the text content. Returns a formatted Markdown list with comprehensive details. Requires Bitbucket credentials.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Pagination cursor for retrieving the next set of results. Obtained from previous response when more results are available. | |
| limit | No | Maximum number of items to return (1-100). Controls the response size. Defaults to 25 if omitted. | |
| projectKey | No | Filter repositories by project key. Example: "project-api" | |
| query | No | Query string to filter repositories by name or other properties (text search). Example: "api" for repositories with "api" in the name/description. If omitted, returns all repositories. | |
| role | No | Filter repositories by the authenticated user's role. Common values: "owner", "admin", "contributor", "member". If omitted, returns repositories of all roles. | |
| sort | No | Field to sort results by. Common values: "name", "created_on", "updated_on". Prefix with "-" for descending order. Example: "-updated_on" for most recently updated first. | |
| workspaceSlug | No | Workspace slug containing the repositories. 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" |