agentskillexchange Apply repeatable JavaScript and TypeScript codemods across large codebases with jscodeshift
Use jscodeshift when an agent needs AST-based JavaScript or TypeScript codemods for bulk migrations, API rewrites, and large refactors with reviewable diffs.
Prerequisites
Node.js, npm or pnpm, Git
Installation
Use the upstream install or setup path that matches your environment:
- $ npm install -g jscodeshift
- make the transform more readable.
- To update docs in /docs, use npm run docs.
- To view these docs locally, use npx http-server ./docs
Requirements and caveats from upstream:
- const {run: jscodeshift} = require('jscodeshift/src/Runner')
- const path = require('node:path');
- An AST node is a plain JavaScript object with a specific set of fields, in
Basic usage or getting-started notes:
Get jscodeshift from npm:
This will install the runner as jscodeshift.
VSCode Debugger
Extracted from upstream docs: https://raw.githubusercontent.com/facebook/jscodeshift/HEAD/README.md