Codemod is the AI-powered, community-led platform for automating code migrations, framework upgrades, and large-scale changes.
This repo houses the Codemod CLI and its underlying workflow engine – everything you need to scaffold, test, and run codemods locally or in CI. The CLI can also connect to Codemod’s hosted Registry and Platform when you want to publish or orchestrate migrations across many repositories.
- Workflows – Scaffold, test, and orchestrate complex, multi-step migrations with ast-grep YAML or JavaScript ast-grep (jssg).
- Codemod Registry – Share or discover community codemods via
npx codemod publishornpx codemod search. - Codemod MCP – AI tools for code analysis, AST manipulation, and codemod creation in AI-powered IDEs.
# 1) Scaffold a new codemod project
npx codemod init my-codemod
# 2) Test it locally
npx codemod workflow run -w my-codemod/workflow.yaml
# 3) Publish it when you're ready
npx codemod publish my-codemod
# 4) Run it from the Registry
npx codemod @codemod/my-codemodSee the full CLI reference for every command and option.
The CLI is the engine that powers campaigns inside Codemod Platform. Need to coordinate changes across multiple repositories, track progress, or collaborate with your team? The Platform adds insights, orchestration, dashboards, and authoring tools that help teams successfully land large-scale code migrations.
Learn more in the docs and share feedback on the feedback board. We also hang out in Slack — join us at go.codemod.com/community.
We welcome contributions to the Codemod CLI. Please see the contributing guide to get started.
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!