Home

gh-bbc-exporter

A GitHub gh CLI extension for exporting Bitbucket Cloud repositories into a format compatible with GitHub Enterprise migrations.

Overview

This extension helps you migrate repositories from Bitbucket Cloud to GitHub Enterprise Cloud, GitHub Enterprise Cloud Managed Users, and GitHub Enterprise Cloud with data residency by creating an export archive that matches the format expected by GitHub Enterprise Importer (GEI).

The exporter creates a complete migration archive containing:

• Repository metadata
• Git objects (commits, branches, tags)
• Pull requests with comments
• Pull request reviews
• User information

Installation

gh extension install katiem0/gh-bbc-exporter

For more information: gh extension install.

Prerequisites

• GitHub CLI installed and authenticated
• Bitbucket Cloud workspace administration access
• Go 1.19 or higher (if building from source)

Quick Navigation

• Authentication — Bitbucket authentication options and methods
• Export Command — Exporting repositories from Bitbucket Cloud
• Migrate Command — Combined export and import to GitHub
• Import with GEI — Importing archives using GitHub Enterprise Importer
• Limitations — Known limitations
• Troubleshooting — Common issues and solutions
• Contribute — How to contribute
• Security — Security policy