MigrateX - Migration Tool for SK/AutoGen to MAF

MigrateX cuts migration time from SK/AutoGen to Microsoft Agent Framework with analysis, refactors, and git-native review.

Proof links: Release v0.1.0 · Demo/CLI Usage · Architecture

A semi-automated migration assistant that scans, analyses, and refactors code from Semantic Kernel and AutoGen frameworks to Microsoft Agent Framework.

Installation

pip install -e .

Usage

Analyse codebase (read-only discovery)

migrate analyze /path/to/project --out report.json --verbose

Apply migrations automatically (high-confidence)

migrate apply /path/to/project --auto --pattern-cache cache.yaml --summary summary.md

Git Integration (Default - Primary Strategy): By default, MigrateX creates a git branch (migratex/migrate-to-maf) and shows git diff after migration:

# Uses git branch by default
migrate apply /path/to/project --auto

# Custom branch name
migrate apply /path/to/project --auto --branch-name "my-migration-branch"

# Disable git operations
migrate apply /path/to/project --auto --no-git-branch

# Disable git diff display
migrate apply /path/to/project --auto --no-show-diff

Apply migrations with review (interactive)

migrate apply /path/to/project --review --diff --remember-decisions

Manage patterns

migrate patterns list
migrate patterns cache --clear

Architecture

• CLI-first: Python CLI tool as primary interface
• Agent-based: Specialized agents for different concerns
• Pattern-driven: Rule-based pattern detection and transformation
• Python MVP: Initial support for Python codebases

Project Structure

• migratex/: Core CLI tool (MVP)
• extension/: VS Code extension (Phase 2+)
• tests/: Test suite
• migratex/docs/: Documentation and migration guides

Development

This tool is under active development.

Note: VS Code extension is planned for Phase 2. Current MVP focuses on CLI functionality.