Campaigns

Campaigns let engineering teams centrally automate and orchestrate large code changes like security patches, language or framework upgrades, API updates, i18n, and other major refactors or optimizations across teams and repos.

Codemod Campaigns provide:

• Campaign configuration - Different teams or repos have different needs. Edit parameters, defined in workflow.yaml, right from the UI.
• Centralized state management - Auto-create and track tasks and PRs across the organization with a shared persistent state.
• Multi-repo orchestration - Run workflows across multiple repos with ease.

Starting a Campaign

Make sure the Codemod GitHub App is installed on repositories you plan to migrate.

1. Create

   Navigate to Campaigns -> Create Campaign in the Codemod app.

2. Configure

   Configure:

   • Codemod package – The Codemod package that you want to run. This can be an existing package, a custom pro codemod (for enterprise customers), or one you create yourself. You can build Codemod packages using Codemod MCP or Studio.
   • Target Repository – The repository that you want to run the Codemod package on.
   • Campaign Name & Description – Give your Campaign a descriptive name and description.
3. Run

   Click Run to initiate the Campaign.

   Each Campaign defines one or more steps that Codemod will run for the target repository. Codemod opens pull requests, tracks status, and surfaces metrics so you always know what’s left.

Creating custom workflows

While a Campaign may be as simple as a single automated codemod, most migrations involve a sequence of steps. You can design those steps by building Codemod workflows. Pro and enterprise customers can request custom workflows.

Learn more about Codemod workflows →