Mainframe Migration Toolkit

Python tools and runtime support for specification-led COBOL and JCL migrations to PySpark.

Installation

Install the complete runtime:

python -m pip install "mainframe-migration-toolkit[all]"

Python 3.10 or newer is required. Java 17 is required for the bundled dataset validator and is recommended when running PySpark pipelines.

Quick start

Initialize a migration workspace from its parent directory:

python -m mainframe_toolkit init-workspace .

The command creates an isolated migration/ Git repository and preserves existing source, input, and golden-dataset directories outside that repository.

Inspect the initialized workspace:

python -m mainframe_toolkit inspect migration --strict

Claude Code can run the orchestrated multi-agent workflow from migration/:

claude --agent mainframe-migration-supervisor

In Devin, invoke migrate-mainframe-job for a single-agent migration without ACP, or mainframe-migration-supervisor for the ACP orchestration flow.

Other commands parse JCL and copybooks, convert sequential datasets, scaffold PySpark jobs, analyze source similarity, coordinate ACP agents, and validate output against golden datasets. Run python -m mainframe_toolkit --help for the complete command list.