halostatue/fish-fzf

This plugin is archived as I am now using PatrickF1/fzf.fish instead of jethrokuan/fzf, and the changes here are less useful than the core functionality provided by Patrick’s plug-in.

A quick plugin for fish shell that provides some useful default configuration options for fzf over and above jethrokuan/fzf.

[][]

Installation

Install with [Fisher][] (recommended):

# Fisher 3.x
fisher add halostatue/fish-fzf

# Fisher 4.0+: Dependencies must be declared explicitly
fisher install jethrokuan/fzf halostatue/fish-fzf

Not using a package manager?

Copy conf.d/*.fish to your fish configuration directory preserving the directory structure.

System Requirements

[fish][] 3.0+
jethrokuan/fzf
fzf

System Configuration (conf.d)

If fzf is installed in $HOME/.fzf, adds $HOME/.fzf/bin to $fish_user_paths.
Sets a useful global value for $FZF_FIND_FILE_COMMAND if one of [pt (the platinum searcher)][], [rg (ripgrep)][], or [ag (the silver searcher)][] are installed.
Sets a useful global value for $FZF_FIND_FILE_OPTS that will take advantage of [bat][], [highlight][], rougify, coderay, cat, or tree.
Sets a useful global value for $FZF_CD_OPTS using tree.
Sets a useful global value for $FZF_REVERSE_ISEARCH_OPTS offering a hidden preview activated with ?.

Completion Widgets

None of the included completion widgets are bound by default.

_halostatue_fish_fzf_bcd_widget

Use fzf to select a parent directory from the current directory.

_halostatue_fish_fzf_cdhist_widget

Use fzf to choose a directory that has previously been visited.

_halostatue_fish_fzf_select_widget

Run the current command-line which produces output piped through fzf. Replace the command-line with the unescaped selection.

Functions

Most of these functions are translated to fish from zsh implementations from the fzf wiki [examples][]. Many of the completion widgets in conf.d/halostatue_fish_fzf.fish are from the fzf wiki [Fish examples][].

fbr

Checkout a git branch (including remote branches), sorted by the most recent commit, limit of the last 30 branches.

fbr

fco

Checkout a git branch or tag. If -p or --preview is provided, displays a preview showing the commits between the tag/branch and HEAD.

fco [-p|--preview]

fe

Open the selected file with the default editor, bypassing the fuzzy finder if there’s only one match and exiting if there’s no match.

fe [PATTERN]

fo

Open the selected file with open (when Ctrl-O is pressed in the finder) or the default editor (when Ctrl-E or Enter are pressed in the finder).

fo [PATTERN]

fkill

Shows processes that your user can kill and kills the selected process.

fkill

fshow

Browse commits. With -p or --preview, shows a preview.

fshow
fshow -p

fstash

A git stash browser. Enter shows the contents of the stash; Ctrl-D shows a diff of the stash against your current HEAD; Ctrl-B checks the stash out as a branch, for easier merging.

License

MIT

restacksyj/fish-fzf