Select commands, files, or processes using percol's fuzzy selection.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Abreu 61b4353436
Updated README.md
11 months ago
completions Initial commit 11 months ago
functions Initial commit 11 months ago
hooks Initial commit 11 months ago
subfunctions Initial commit 11 months ago
.gitignore Initial commit 11 months ago
LICENSE Initial commit 11 months ago
README.md Updated README.md 11 months ago
key_bindings.fish Initial commit 11 months ago

README.md

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.