PECO(1)

📦
version 0.5.10 · 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ PECO(1) ✨

okay bestie, welcome to the User Commands corner of the manual, this is peco and she is THAT girl 💅

🌸 NAME 🌸

peco — a Simplistic interactive filtering tool. that's it. that's the whole vibe. no cap 🫶

🎀 SYNOPSIS 🎀

peco [options] [FILE]

like… give her some options, maybe a file, and watch her filter ✨

👑 OPTIONS 👑

here's the full menu, every single one, no skips, no crumbs left behind 🍓

  • -h, --help — shows this help message and exits. your girl is helpful like that 💖
  • --query — the initial value for the query. she starts pre-typed, main character energy 👑
  • --rcfile — path to the settings file. tell her where the config lives 🎀
  • --version — prints the version and exits. quick lil flex ✨
  • -b, --buffer-size — number of lines to keep in the search buffer. it's giving memory management 🧠
  • --null — expect NUL (\0) as the separator for target/output. yes, the literal null byte, not a vibe check 💀
  • --initial-index — position of the initial index of the selection. and heads up: it's 0 base, so first thing is 0 bestie 🙈
  • --initial-matcher — specify the default matcher. ngl this one is deprecated 😭
  • --initial-filter — specify the default filter. the glow-up successor fr fr 🌈
  • --prompt — specify the prompt string. make her say what you want her to say 💬
  • --layout — the layout to be used. it's either 'top-down' or 'bottom-up', and the default is 'top-down'. periodt 🎯
  • --select-1 — selects the first item and immediately exits if the input contains only 1 item. only one? she's not doing a whole thing, she's done 🦋
  • --on-cancel — specify the action on user cancel. either 'success' or 'error', and the default is 'success'. ⚠️ heads up though: this may change in future versions, so don't get too attached 🥲
  • --selection-prefix — uses a prefix instead of changing the line color to indicate the currently selected lines. the default is to use colors. 🚨 this option is experimental, so treat her gently 💜
  • --exec — execute a command instead of finishing/terminating peco. ⚠️ please note, bestie: this command will receive the selected line(s) from stdin, and will be executed via '/bin/sh -c' or cmd /c. so like, be careful who you hand the aux to 🔥
ngl, that --exec one is a whole lot of power in one flag. read it twice, bestie, then read it again 💀

and that's the whole page!! ty for coming to my ted talk 🫶

this was peco version v0.5.1, dated December 2017, and yes she's still iconic for it 👑✨

📦 where this page comes from