Migration tools

Camunda is invested in supporting and easing your migration from Camunda 7 to Camunda 8 with migration tools. You can use them in two ways:

• Agentic migration (recommended): An AI coding agent orchestrates the tools by running diagram conversion and code refactoring automatically, so you can focus on reviewing changes and rearchitecting your solution.
• Manual migration: Run the individual tools yourself for full control or to handle specific migration tasks independently.

All tools are available as ready-to-use builds from the GitHub releases page.

Agentic migration

The Camunda migration agent skill is an AI-driven orchestrator that runs the migration tools on your behalf. It handles the tool calls so you can focus on rearchitecting your solution.

Install and run

If you use an Agent Skills-compatible AI coding agent (such as Claude Code), install it as follows:

claude plugin marketplace add camunda/camunda-7-to-8-migration-tooling
claude plugin install camunda-migration

Install with other agents

The skill follows the open Agent Skills format and works with any compatible agent. See the Agentic Migration Skills README for manual installation.

Run from your Camunda 7 project directory:

/camunda-migration:migrate-c7-to-c8-code

The skill asks for your migration scope:

Scope	What the agent does
Code + models (recommended, default)	Runs Diagram Converter CLI + OpenRewrite + AI cleanup on code and diagrams together
Code only	OpenRewrite + AI on Java code
Models only	Diagram Converter CLI + AI on BPMN/DMN files
Assessment only	Inventories files and estimates effort without changes

Agent workflow

1. Assess migration scope: Inventories BPMN/DMN diagrams and Java code files, and estimates effort.
2. Convert diagrams: Runs the Diagram Converter CLI; AI resolves REVIEW, WARNING, and TASK findings.
3. Migrate code: Runs OpenRewrite recipes; AI handles TODOs, edge cases, tests, and configuration.
4. Validate migration results: Compiles, runs tests, and searches for remaining C7 references.
5. Fix remaining issues: Offers to fix remaining issues, and waits for your review before each change.

Manual migration

Camunda provides the following tools for manual migration:

Migration tool	Description	GitHub link
Diagram Converter	Gain an initial understanding of migration tasks. Available for local installation (Java or Docker) or hosted as a free SaaS offering.	Migration Tooling – Diagram Converter
Data Migrator	Copies Camunda 7 runtime instances and history (audit log) to Camunda 8.	Migration Tooling – Data Migrator
Code Conversion Utilities	Mixture of code mapping tables, code conversion patterns, and automatable refactoring recipes.	Migration Tooling – Code Conversion

Examples

Example	Description	GitHub link
Simple end-to-end example	Shows all tools in action for a simple Spring Boot Java solution.	Camunda 7 to 8 migration example