← 返回命令列表

Linux command

serpl 命令

文本

复制后可按需替换文件名、目录或参数。

常用示例

Launch search and replace in the current directory

serpl

Search and replace in a specific project directory

serpl --project-root [/path/to/project]

Show version and config file location

serpl --version

说明

serpl is a TUI that lets you search and replace text across an entire project folder, mimicking VS Code's search-and-replace experience. It uses ripgrep for fast searching and optionally ast-grep for syntax-aware matching. It supports multiple search modes (simple, match case, whole word, regex, AST Grep) and replace modes (simple, preserve case) with an interactive preview of changes before committing them. Key bindings are configurable via a config.json file.

参数

--project-root _PATH_
Specify the project root directory for search operations. Defaults to the current directory.
--version
Display version information and configuration file path.

FAQ

What is the serpl command used for?

serpl is a TUI that lets you search and replace text across an entire project folder, mimicking VS Code's search-and-replace experience. It uses ripgrep for fast searching and optionally ast-grep for syntax-aware matching. It supports multiple search modes (simple, match case, whole word, regex, AST Grep) and replace modes (simple, preserve case) with an interactive preview of changes before committing them. Key bindings are configurable via a config.json file.

How do I run a basic serpl example?

Run `serpl` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does --project-root _PATH_ do in serpl?

Specify the project root directory for search operations. Defaults to the current directory.