pick — fuzzy
pick utility allows users to select
from a set of choices using an
interface with fuzzy search functionality.
The choices are read from stdin, and the
selected choice written to stdout.
The options are as follows:
- Read and display descriptions. Input lines will be split into two parts by
the last occurrence of
IFS. Both parts will be
displayed but only the first part will be used when searching.
- Disable toggling of keypad transmit mode. Useful when running
pick from within another interactive program which
already has set the correct transmit mode.
- Output description of selected choice on exit.
- Supply an initial search query.
- Disable sorting. Only filter the choices instead of additionally sorting
by score. This option can be toggled from within the interface, see
- Enable the use of the alternate screen terminal feature. This is the
- Disable the use of the alternate screen terminal feature.
- Exit with a erroneous status without outputting the selected choice. While
this command often being defined as Ctrl-C it is determined by the
VINTR control character, see
- Redraw interface with respect to the current size of the terminal.
- Toggle sorting.
- Select between choices matching the current search query.
- Move the selection to the choice located one page down/up from the
currently selected choice.
- Move the selection to the first/last choice matching the current search
- Output the currently selected choice and exit.
- Output the current input query and exit.
- Move the cursor left and right in the search query input field.
- Move the cursor to the beginning of the line in the search query input
- Move the cursor to the end of the line in the search query input
- Delete one character to the left of the cursor in the search query input
- Delete the character under the cursor in the search query input
- Delete the word to the left of the cursor. A word is recognized as a
sequence of characters for which either
true or the character is an underscore.
- Delete to the beginning of the line in the search query input field.
- Delete to the end of the line in the search query input field.
- Added to the search query and will refine the current search.
The following environment variables will affect the execution of
- Determines the separator used between choices and descriptions.
Select a file in the current directory to open using
$ find . -type f | pick | xargs
Select a command from the history to execute:
$ eval $(fc -ln 1 |
pick utility exits 0 on
success, and >0 if an error occurs.
The first version of
pick was released on
August 18, 2014. Development was sponsored by
thoughtbot from the start of
the project until September 2016.