Repository files navigation

Platform ·Community ·Docs

Codemod is the AI-powered, community-led platform for automating code migrations, framework upgrades, and large-scale changes.

This repo houses theCodemod CLI and its underlyingworkflow 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 vianpx codemod publish ornpx codemod search.
• Codemod MCP – AI tools for code analysis, AST manipulation, and codemod creation in AI-powered IDEs.

# 1) Scaffold a new codemod projectnpx codemod init my-codemod# 2) Test it locallynpx codemod workflow run -w my-codemod/workflow.yaml# 3) Publish it when you're readynpx codemod publish my-codemod# 4) Run it from the Registrynpx codemod @codemod/my-codemod

See the fullCLI reference for every command and option.

The CLI is the engine that powers campaigns insideCodemod 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 thedocs and share feedback on thefeedback board. We also hang out in Slack — join us atgo.codemod.com/community.

We welcome contributions to the Codemod CLI. Please see thecontributing guide to get started.

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 theall-contributors specification. Contributions of any kind welcome!