fzf-brew (fish)

A fish-native rewrite of the fzf-brew Zsh plugin. It provides fast, fuzzy install/uninstall helpers for Homebrew formulae and casks, with previews and a homepage opener.

Contents

• Screenshots
• Requirements
• Install
• Usage
• Configuration
• Development
  • Local Testing
  • Tests
• License

Screenshots

Requirements

• fish 3.0+
• Homebrew (brew)
• fzf (fzf)

Install

• With fisher:

fisher install devadathanmb/fzf-brew

• With oh-my-fish:

omf install https://github.com/devadathanmb/fzf-brew

Usage

Commands match the original aliases:

• fbi — fuzzy install formulae
• fbui — fuzzy uninstall formulae
• fci — fuzzy install casks
• fcui — fuzzy uninstall casks

You can pass an initial query string:

fbi rip

During selection:

• shift-tab toggles multi-select (fzf default)
• ctrl-o opens the homepage for the highlighted item

Configuration

fzf-brew exposes a small set of variables under the FZF_BREW_ prefix. These control behavior specific to this plugin.

• FZF_BREW_HOME_BIND Key binding used to open the homepage of the highlighted item (default: ctrl-o)

All other UI and interaction details—such as layout, height, preview window behavior, colors, and key bindings—are provided directly by fzf itself.

You can customize those using standard fzf mechanisms, for example:

• FZF_DEFAULT_OPTS
• fzf command-line options
• Environment variables or shell configuration

This plugin simply forwards those options to fzf without redefining them.

Development

Local Testing

To test the plugin locally from this repo without installing it:

1. Clone the repository:

git clone https://github.com/devadathanmb/fzf-brew.git

2. Change into the repo:

cd fzf-brew

3. Source the functions from your working tree:

for f in functions/*.fish
    set -l fn (string replace -r '\.fish$' '' -- (basename $f))
    functions -e $fn 2>/dev/null
    source $f
end

Then run any of the plugin commands:

fbi
fbui
fci
fcui

Tests

To run the test suite:

fish tests/run.fish

License

GPL v3