Getting started
Get started with building codemods using Codemod Studio.
Codemod Studio allows you to “instantly” create code automation bots with the help of AI, specialized helpers, and debuggers, as well as a vibrant community of “codemod champions.”
Building codemods with Codemod Studio
Add before/after snippets
The user-defined code snippets in the before/after panels are used by the AI helper to generate a codemod based on the changes in code between both snippets.
To start building codemods, you can:
- insert the original code into the ‘Before’ panel, then insert how the code should look like after transformation into the ‘After’ panel
- or you can use the
codemod learn
command straight from your IDE/CLI to automatically populate the before/after snippets.
Use AI helper
The assistant section provides support and guidance throughout the codemod creation and execution process. It leverages AI to help users generate codemod scripts, troubleshoot issues, and refine their code transformations.
To use the AI helper, make sure that the before/after panels are correctly populated, then use the available actions or prompt builders to iteratively build your codemod.
Codemod editor
The codemod editor allows you to review and edit the generated codemod. This makes it easy to tweak your codemod without having to leave your studio environment.
Output panel
The output panel dynamically reflects how the codemod affects the Before
snippet in real-time.
This immediate feedback loop helps you quickly identify and correct any issues in your codemod without having to export and run it over your local project.
AST viewer
The AST viewer enables you to see a detailed view of the before and after snippets’ Abstract Syntax Tree (AST).
This feature is especially useful for experienced codemod builders who want to edit/build codemods manually.
The AST viewer is made for more advanced codemod developers. If you intend to build codemods using the AI helper only, you can skip using this feature.
Debugger
The debugger displays the events that occur any caught errors when running the codemod. This allows you to easily trace and debug your codemod if it doesn’t work as expected.
You can use console.log
in the codemod editor to print out any output in the debugger.
Sharing codemods
After building a codemod, you can click Share
to get a shareable public link to your codemod.
This allows you to easily share and test your codemods with friends, team members, and the community.
Running codemods
Once you are done with building your codemod, you can instantly publish the codemod privately and run it locally over your project using Codemod CLI.
Publish codemod
Click Run via CLI
to instantly publish the codemod to your private registry.
Run via Codemod CLI
Run the codemod using Codemod CLI.
Alternatively, you can download the codemod package locally and run it with Codemod CLI or publish it publicly to Codemod Registry.
Was this page helpful?