peco

Simplistic interactive filtering tool.

Runs as peco|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Command form

ai-draft · 1 task · 10 fields

Filter lines from stdin interactively with peco. Configuration-file keybindings and --exec are left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui peco

Interactive filterExample values, fixed in this page — nothing here reaches a terminal

Basic

Initial query

string

Layout

3 choicesenum

Inline height*

10string

TasksEach one presets the form for one job

Inline picker

heightlayoutquery

ParametersOnly these flags are editable in the form

Initial query

string

--query

Initial filter

enum

--initial-filterIgnoreCaseCaseSensitiveSmartCaseIRegexpRegexpFuzzy

Layout

enum

--layouttop-downbottom-uptop-down-query-bottom

Inline height

Lines or percentage (for example 5 or 40%). Empty uses the full screen.
string

--height

Prompt

string

--prompt

Auto-select a single line

boolean

--select-1

Exit on empty input

boolean

--exit-0

Print query first

boolean

--print-query

Exit status on cancel

enum

--on-cancelsuccesserror

Config file

path

--rcfile

SourcesEvery flag above is checked against these

help

manual2026-10-27

raw.githubusercontent.com

Before it fills your prompt, Otty checks the installed peco against its version. A form that does not match your version is not offered.