[![Build Status](]( [![Codecov](](https://codecov.
Last updated 6 months ago by heroprotagonist .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install recursive-rename -g
SYNC missed versions from official npm registry.


Build Status Codecov NPM version


Recursive rename is a simple tool used to manipulate file names.

It can be used from the command line or NodeJS.



rename jsx js

Rename all .jsx files to .js in current directory. By default node_modules and .git are excluded from the crawl. This can be overridden and/or extended.

rename jsx js --dry

Adding the dry flag will return the files that would be changed.


Equivalent operations can be performed in Node

import Rename = 'recursive-rename'

const rename = new Rename({
  src: 'jsx',
  dest: 'js',


Add dry option to get insight on the renaming process without performing it

  dry: true,


yarn add recursive-rename


yarn global add recursive-rename

  • Global installation with expose the rename command

If you have not switched to yarn. Simply use npm

npm install recursive-rename

  • use -g flag for global installation


Comand Line

rename $SRC $DEST

$SRC will be the extensions that will be renamed to $DEST extension. These are required. If the path is not provided it will default to the current directory.

Optional flags

 --dry [if present the renaming will not occur, but a list of the changes that would occur are shown]
 --exclude [set to folder that should not be touched]
 --override [if present remove default excluded folders. These are .git and node_modules]
 --path [set to path of folder to rename if not targeting current directory]

Informational flags



Using babel

import Rename from 'recursive-rename'


const Rename = require('recursive-rename')


Create a new instance that will be used to traverse directory and perform renaming.

Options [object]
- src [string]: required
- dest [string]: required
- exclude [array]
- override [array]



Once instantiated rename has the dive method. This will perform the crawl based on the options supplied to Rename constructor.

Options [object]
- dry [bool] (if present renaming will not occur and output will be list of what would)

Current Tags

  • 1.0.0                                ...           beta (4 years ago)
  • 4.0.0                                ...           latest (6 months ago)

6 Versions

  • 4.0.0                                ...           6 months ago
  • 3.0.0                                ...           a year ago
  • 2.0.0                                ...           4 years ago
  • 1.2.0 [deprecated]           ...           4 years ago
  • 1.1.0 [deprecated]           ...           4 years ago
  • 1.0.0 [deprecated]           ...           4 years ago
Maintainers (1)
Today 0
This Week 0
This Month 6
Last Day 0
Last Week 6
Last Month 2
Dependencies (5)
Dev Dependencies (17)

Copyright 2014 - 2016 © |