findr icon indicating copy to clipboard operation
findr copied to clipboard

๐Ÿ”Ž 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

  • :white_check_mark: ย  Mac
  • :white_check_mark: ย  Linux
  • :gear: ย  Windows (WIP)

Features

  • :white_check_mark: ย  Find
  • :white_check_mark: ย  Replace
  • :white_check_mark: ย  Colorized output
  • :white_check_mark: ย  Highlight and preview occurrences
  • :white_check_mark: ย  Select files to replace
  • :white_check_mark: ย  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