id = "bb-cli"
name = "Bitbucket CLI"
homepage = "https://bb-cli.github.io"
description = "Bitbucket Rest API CLI written in pure PHP."
executables = ["bb"]

[dotfiles]

# https://github.com/bb-cli/bb-cli documents the user's
# ~/.bitbucket-rest-cli-config.json (including its Docker bind mount). It is
# the Bitbucket authentication/configuration file and may contain credentials,
# so classify the whole file as a secret.
paths = []
exclude = []
secret = ["~/.bitbucket-rest-cli-config.json"]

[commands]
format = 1
label = "Bitbucket CLI"
description = "Create a pull request, list pull requests, or run a pipeline for a branch in the current Bitbucket repository. Other bb commands are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.subcommand]]
path = ["pr", "create"]
label = "Create a pull request"
description = "Source defaults to the current branch. Default reviewers are added automatically."

[[commands.subcommand.source]]
id = "docs"
kind = "manual"
url = "https://bb-cli.github.io/docs/commands/pull-request.html"
revision = "2026-10-27"
evidence = """
bb pr create <target-branch> [source-branch] [options] Create pull request. If source-branch is omitted, the current branch is used as source.
-i Interactive mode - prompts for missing title and/or description
--title "..." Set the PR title (non-interactive)
--description "..." Set the PR description (non-interactive)
bb pr create develop --title "Fix login bug" --description "Resolves timeout issue on auth endpoint"
"""

[[commands.subcommand.field]]
id = "target"
label = "Target branch"
type = "string"
position = 0
sources = ["docs"]

[[commands.subcommand.field]]
id = "source"
label = "Source branch"
type = "string"
position = 1
sources = ["docs"]

[[commands.subcommand.field]]
id = "title"
label = "Title"
type = "string"
option = ["--title"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "description"
label = "Description"
type = "string"
option = ["--description"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "interactive"
label = "Prompt for missing title/description"
type = "boolean"
option = ["-i"]
sources = ["docs"]

[[commands.subcommand.task]]
id = "create"
label = "Create a pull request"
fields = ["target", "source", "title", "description", "interactive"]
required = ["target"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["target", "source", "title", "description", "interactive"]

[[commands.subcommand]]
path = ["pipeline", "run"]
label = "Run a pipeline"
description = "Runs the pipeline defined in bitbucket-pipelines.yml for a branch."

[[commands.subcommand.source]]
id = "docs"
kind = "manual"
url = "https://bb-cli.github.io/docs/commands/pipeline.html"
revision = "2026-10-27"
evidence = """
bb pipeline run <branch-name> Runs pipeline for given branch (defined in bitbucket-pipelines.yml file).
"""

[[commands.subcommand.field]]
id = "branch"
label = "Branch"
type = "string"
position = 0
sources = ["docs"]

[[commands.subcommand.task]]
id = "run"
label = "Run pipeline"
fields = ["branch"]
required = ["branch"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["branch"]