Select commands, files, or processes using percol's fuzzy selection.
Go to file
2021-08-10 15:38:31 -03:00
completions Initial commit 2021-08-10 00:42:21 -03:00
functions Initial commit 2021-08-10 00:42:21 -03:00
hooks Initial commit 2021-08-10 00:42:21 -03:00
subfunctions Initial commit 2021-08-10 00:42:21 -03:00
.gitignore Initial commit 2021-08-10 00:42:21 -03:00
key_bindings.fish Initial commit 2021-08-10 00:42:21 -03:00
LICENSE Initial commit 2021-08-10 00:42:21 -03:00
README.md Updated README.md 2021-08-10 15:38:31 -03:00

GPL License Fish Shell Version Oh My Fish Framework

fuzzy

A tool to fuzzy search commands, files, or processes based on percol, the simplistic interactive filtering tool.

Additional options

-y/--history

Search for a command in your history and set it as the current command line

-t/--terminate

Search current processes, and terminate those selected.

-f/--file

Search for a file and print its full path.

-o/--open

Combined with -f/--file, open selected file with the default application for it's format.

-c/--commands

Search for examples of command line usage. It also has two suboptions:

  • -u/--update: Update the command list from where to draw examples from
  • -e/--editor: Modify, or create, a page with usage examples of a given command.

Install

omf repositories add https://gitlab.com/argonautica/argonautica 
omf install fuzzy

Dependencies

If any of the following dependencies isn't installed, upon installing fuzzy you'll be prompted to install them.

percol tldr curl mlocate file sensible-utils xdg-open feedback contains_opts

Keybinding configuration

By default, this script binds Alt+H, Alt+T, Alt+O and Alt+C to the additional fish options, passing the current command line as an argument.

bind \eh 'fuzzy --history (commandline)'
bind \et 'fuzzy --terminate (commandline); commandline ""'
bind \eo 'fuzzy --file --open (commandline); commandline ""'
bind \ec 'fuzzy --commands'

Alt+C has a double function: At first, it passes the content of the current command line to percol --comands. After selecting an option from percol --comands, it jumps between spaces to be filled in with arguments.

To change these keybindings, see man bind, and modify the file $HOME/.local/share/omf/pkg/percol_utils/key_bindings.fish.