{
  "id": "bb-cli",
  "name": "Bitbucket CLI",
  "homepage": "https://bb-cli.github.io",
  "description": "Bitbucket Rest API CLI written in pure PHP.",
  "executables": [
    "bb"
  ],
  "dotfiles": {
    "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
    },
    "subcommand": [
      {
        "path": [
          "pr",
          "create"
        ],
        "label": "Create a pull request",
        "description": "Source defaults to the current branch. Default reviewers are added automatically.",
        "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.\n-i Interactive mode - prompts for missing title and/or description\n--title \"...\" Set the PR title (non-interactive)\n--description \"...\" Set the PR description (non-interactive)\nbb pr create develop --title \"Fix login bug\" --description \"Resolves timeout issue on auth endpoint\"\n"
          }
        ],
        "field": [
          {
            "id": "target",
            "label": "Target branch",
            "type": "string",
            "position": 0,
            "sources": [
              "docs"
            ]
          },
          {
            "id": "source",
            "label": "Source branch",
            "type": "string",
            "position": 1,
            "sources": [
              "docs"
            ]
          },
          {
            "id": "title",
            "label": "Title",
            "type": "string",
            "option": [
              "--title"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "description",
            "label": "Description",
            "type": "string",
            "option": [
              "--description"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "interactive",
            "label": "Prompt for missing title/description",
            "type": "boolean",
            "option": [
              "-i"
            ],
            "sources": [
              "docs"
            ]
          }
        ],
        "task": [
          {
            "id": "create",
            "label": "Create a pull request",
            "fields": [
              "target",
              "source",
              "title",
              "description",
              "interactive"
            ],
            "required": [
              "target"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "target",
              "source",
              "title",
              "description",
              "interactive"
            ]
          }
        ]
      },
      {
        "path": [
          "pipeline",
          "run"
        ],
        "label": "Run a pipeline",
        "description": "Runs the pipeline defined in bitbucket-pipelines.yml for a branch.",
        "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).\n"
          }
        ],
        "field": [
          {
            "id": "branch",
            "label": "Branch",
            "type": "string",
            "position": 0,
            "sources": [
              "docs"
            ]
          }
        ],
        "task": [
          {
            "id": "run",
            "label": "Run pipeline",
            "fields": [
              "branch"
            ],
            "required": [
              "branch"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "branch"
            ]
          }
        ]
      }
    ]
  }
}