Platform · Community · Docs

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.

• 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.

# 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.

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.

There are two ways to contribute to the Codemod ecosystem:

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

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.

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!