@codemod-utils/cli

CLI to create a codemod project

Usage

Step 1. Use pnpx to run @codemod-utils/cli.

pnpx @codemod-utils/cli <your-codemod-name> [options]

This will create a folder named <your-codemod-name>.

Step 2. Make the first commit. Change to the codemod directory, then run these scripts in sequence:

# Install dependencies
pnpm install

# Commit changes
git init
git add .
git commit -m "Initial commit"

# Push changes (to a new repo)
git remote add origin [email protected]:<your-github-handle>/<your-repo-name>.git
git branch -M main
git push -u origin main

Options

addon

By default, @codemod-utils/cli only installs the core packages: @codemod-utils/files and @codemod-utils/tests. Every codemod will need them.

If your codemod needs more, pass --addon and list the package name (without the prefix @codemod-utils/).

pnpx @codemod-utils/cli --addon blueprints package-json

Possible values for --addon are:

• ast-javascript
• ast-template
• ast-template-tag
• blueprints
• ember
• package-json

root

Pass --root to run the codemod somewhere else (i.e. not in the current directory).

pnpx @codemod-utils/cli --root <path/to/your/project>

typescript

By default, @codemod-utils/cli creates a TypeScript project to help you maintain and extend the codemod.

To create a JavaScript project, set --typescript to false.

pnpx @codemod-utils/cli --typescript false

Compatibility

• Node.js v20 or above

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.