Skip to content

Bitbucket → GitHub Migration Tools

Intelligent • Safe • Comprehensive

Migrate your Bitbucket Cloud repositories to GitHub with confidence using our smart migration platform that preserves everything while making intelligent decisions about PRs, branches, and metadata.

🚀 Get Started • 📖 Full Guide

⚡ Key Features

  • 🧠 Smart PR Migration

    Open PRs become GitHub PRs, closed PRs become Issues with full metadata preservation. No more broken references or lost context.

  • 🛡️ Safe by Design

    Conservative approach prevents re-merging closed PRs. Comprehensive dry-run validation ensures successful migrations.

  • 🔍 Pre-Migration Audit

    See exactly what will migrate before you start. Get user mapping recommendations and gap analysis automatically.

  • 🔗 Automatic Link Rewriting

    Cross-references between issues and PRs are automatically updated to point to GitHub while preserving original context.

🚀 Quick Start

Install: 

pipx install bitbucket-migration

Example Usage: 

migrate_bitbucket_to_github audit --workspace YOUR_WORKSPACE --repo YOUR_REPO
migrate_bitbucket_to_github dry-run --config migration_config.json

📚 Documentation

  • 📖 Migration Guide

    Complete step-by-step migration process with detailed explanations, checklists, troubleshooting, and attachment upload instructions.

  • ⚙️ Migration Config

    Configuration file format, user mapping, and repository mapping options.

  • 📋 Migration Details

    Detailed reference on what metadata is preserved and how non-migratable information is handled.

  • 🖥️ CLI Reference

    Command-line interface guide for audit, migration, and authentication scripts.

  • 👥 User Mapping

    How to map Bitbucket users to GitHub accounts and handle unmapped users.

  • 🔑 API Tokens

    Setup guides for Bitbucket and GitHub API authentication.

Built with ❤️ for reliable repository migrations

🐛 Report Issues • 📚 API References