vmarcosp / findr

🔎 A simple and intuitive find & replace command-line interface.

Preview • Features • Commands • License

Preview

Find command

Replace command + regex

Installation

Using npm or yarn

npm i -g @vmarcosp/findr
# or
yarn global add @vmarcosp/findr

Using curl + script

curl -fsSL https://github.com/vmarcosp/findr/raw/master/scripts/install.sh | bash

OS Support

• ✅   Mac
• ✅   Linux
• ⚙️   Windows (WIP)

Features

• ✅   Find
• ✅   Replace
• ✅   Colorized output
• ✅   Highlight and preview occurrences
• ✅   Select files to replace
• ✅   Regex support
• ⚙️   Select ocurrences to replace (WIP)

Commands

Find command:

Positional arguments:

• 1º Text to find

Named arguments:

• --folder or -f
• --regex or -r regex mode
• --extension or -e filter files by extension

Example:

  # Basic usage
  findr find "write_file" --folder src

  # Filtering by extension
  findr find "write_file" --folder src --extension re,js

Replace command:

Positional arguments:

• 1º Text to replace
• 2º New text

Named arguments:

• --folder or -f
• --regex or -r regex mode
• --extension or -e filter files by extension

Example:

  # Basic usage
  findr replace "write_file" "create_file" --folder src

  # Regex mode
  findr replace "\bwrite_file" "create_file" --folder src --regex

License

MIT