peco

Simplistic interactive filtering tool

Interactive filter

$ ls | peco

Filter with query

$ history | peco --query "[pattern]"

Select file and open with a command

$ find . -type f | peco | xargs [command]

With custom prompt

$ peco --prompt="Select> "

peco [options]

peco is an interactive filtering tool. Select from stdin with fuzzy matching.The tool provides incremental search. Similar to fzf and percol.

--query STRING

Initial query string.

--prompt STRING

Custom prompt string.

--layout TYPE

Display layout: top-down or bottom-up. Default is top-down.

--initial-index N

Start selection at line N.

--rcfile PATH

Path to the settings file.

-b, --buffer-size N

Number of lines to keep in search buffer. Useful when piping from an infinite stream.

--null

Expect NUL (\0) as separator for target/output.

--select-1

Immediately select and exit if input contains only one item.

--on-cancel ACTION

Action on user cancel: success or error. Default is success.

--initial-filter FILTER

Specify the default filter (e.g., Regexp, SmartCase).

Requires a terminal for interactive use. Written in Go. Configuration can be customized via a JSON config file (~/.config/peco/config.json).

peco was created as an interactive grep tool inspired by percol.