Repo Commands - Clone, Create & Manage Bitbucket Repositories

Manage Bitbucket repositories.

Global options available on all repo commands: --json, --no-color, -w, --workspace, -r, --repo.

`bb repo clone`

Clone a Bitbucket repository.

bb repo clone <repository> [options]

Arguments

Argument	Description
`repository`	Repository to clone (`workspace/repo` or full URL)

Options

Option	Description
`-d, --directory <dir>`	Directory to clone into
`--json`	Output as JSON

Examples

# Clone using workspace/repo format
bb repo clone myworkspace/myrepo

# Clone into a specific directory
bb repo clone myworkspace/myrepo -d my-local-dir

# Clone using full URL
bb repo clone git@bitbucket.org:myworkspace/myrepo.git

`bb repo create`

Create a new repository.

bb repo create <name> [options]

Arguments

Argument	Description
`name`	Name for the new repository

Options

Option	Description
`-w, --workspace <workspace>`	Workspace to create repository in
`-d, --description <description>`	Repository description
`--private`	Create a private repository (default)
`--public`	Create a public repository
`-p, --project <project>`	Project key
`--json`	Output as JSON

Examples

# Create a private repository
bb repo create my-new-repo -w myworkspace

# Create a public repository with description
bb repo create my-new-repo -w myworkspace --public -d "My awesome project"

# Create in a specific project
bb repo create my-new-repo -w myworkspace -p PROJ

`bb repo list`

List repositories in a workspace.

bb repo list [options]

Options

Option	Description
`-w, --workspace <workspace>`	Workspace to list repositories from
`--limit <number>`	Maximum number of repositories (default: 25)
`--json`	Output as JSON

Examples

# List repositories in a workspace
bb repo list -w myworkspace

# List more repositories
bb repo list -w myworkspace --limit 50

# List with JSON output for scripting
bb repo list -w myworkspace --json

Notes

--limit is enforced across paginated repository responses

`bb repo view`

View repository details.

bb repo view [repository] [options]

Arguments

Argument	Description
`repository`	Repository to view in `workspace/repo` format (optional if in a repo directory)

Options

Option	Description
`-w, --workspace <workspace>`	Workspace
`--json`	Output as JSON

Examples

# View current repository (from within repo directory)
bb repo view

# View specific repository using workspace/repo format
bb repo view myworkspace/myrepo

# View with explicit workspace option
bb repo view myrepo -w myworkspace

# Get repository details as JSON
bb repo view --json

Notes

The positional [repository] argument is the primary way to specify the repo (e.g., bb repo view myworkspace/myrepo). The global -w and -r flags also work as an alternative.
The command will automatically detect the repository from your current directory’s git remote if you don’t specify one.

`bb repo delete`

Delete a repository. This action is permanent and cannot be undone.

bb repo delete <repository> [options]

Arguments

Argument	Description
`repository`	Repository to delete in `workspace/repo` format

Options

Option	Description
`-w, --workspace <workspace>`	Workspace
`-y, --yes`	Confirm deletion (required)
`--json`	Output as JSON

Examples

# Delete a repository (--yes is required to confirm)
bb repo delete myworkspace/myrepo --yes

# Delete using explicit workspace option
bb repo delete myrepo -w myworkspace --yes