codemod

Platform · Community · Docs

Codemod

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.

Key Features

• Codemod CLI – Run, test, and publish codemods from your terminal or CI.
• Workflows – Orchestrate multi-step migrations with YAML configuration, matrix strategies, and manual approval gates.
• JSSG – JavaScript ast-grep: write powerful AST transformations in TypeScript with pattern matching and semantic analysis.
• Codemod Registry – Share or discover community codemods via npx codemod publish or npx codemod search.
• Codemod MCP – AI tools for code analysis, AST manipulation, and codemod creation in AI-powered IDEs.

Getting Started

# 1) Open the interactive launcher
npx codemod

# 2) Scaffold a new codemod project
npx codemod init my-codemod

# 3) Test it locally
npx codemod workflow run -w my-codemod/workflow.yaml

# 4) Publish it when you're ready
npx codemod publish my-codemod

# 5) Run it from the Registry
npx codemod @codemod/my-codemod

In an interactive terminal, bare npx codemod opens a launcher for creating a package or running one from the registry. In non-interactive contexts, it prints next steps and exits with status 1.

See the full CLI reference for every command and option.

Codemod Platform

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.

Explore our documentation to learn more, and join the conversation or share your feedback in our Slack community.

Contributing

There are two ways to contribute to the Codemod ecosystem:

Contribute to Codemod OSS

Help improve the CLI, workflow engine, and JSSG runtime. See the contributing guide to get started with development setup, testing, and pull requests.

Build and share codemods

Create codemods for framework upgrades, security patches, or common refactoring patterns. Published codemods help the entire community migrate faster.

• Workflows quickstart – Scaffold your first codemod package
• JSSG guide – Write AST transformations in JS/TS
• Publishing – Share your contributions to Codemod Registry

Looking for ideas? Spark a discussion in our Slack community or browse Codemod Registry for codemods that could use improvements.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Alex Bit

Mohamad Mohebifar

Amirabbas Ghasemi

Mohab Sameh

Siamak

Jahred Hope

Jacob Smith

Augustin Mauroy

Bruno Rodrigues

Cameron Seebach

Benny Joo

Grzegorz

Greg Pabian

arshcodemod

Sasha

Mikhail Demidoff

Aleksy

Pardis Pashakhanloo

DmytroHryshyn

kevtran2

Max Leiter

Manish Jha

with-heart

Aniello Falcone

Harsh Gupta

Nuurek

Norayr Baghdasarov

Espen Bye

Jake Riordan

Jonathan Giardino

Mohamed Amine Diboune

Seif Ghezala

Ahmad Soliman

Maciej Lotkowski

Jay Kumar

Shinya Fujino

coderaiser

Zach Wolf

Serhii Melnyk

Henry Q. Dineen

Matthias

Mohammad Bagher Abiyat

Yugal Agarwal

Sameer Poswal

Michael Stramel

George W Langham

Siddhesh Mhadnak

This project follows the all-contributors specification. Contributions of any kind welcome!