Skip to content
/ fzf-make Public

A command line tool that executes commands using fuzzy finder with preview window for make, pnpm, yarn.

License

Notifications You must be signed in to change notification settings

kyu08/fzf-make

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ac88368 · Dec 1, 2024
Nov 28, 2024
Dec 1, 2024
Dec 1, 2024
Jun 22, 2024
Dec 1, 2024
Nov 30, 2024
Nov 30, 2024
Dec 1, 2024
Dec 1, 2024
Mar 8, 2023
Nov 30, 2024
Dec 1, 2024
Dec 15, 2023
Mar 26, 2024
Apr 3, 2024
Dec 1, 2024

Repository files navigation

fzf-make is a command line tool that executes commands using fuzzy finder with preview window. Currently supporting make, pnpm.

License:MIT Latest Release crates.io Crates.io Total Downloads

[English] [Deutsch] [Français]

🛠️ Features

  • Select and execute a make target or pnpm scripts using fuzzy-finder with a preview window by running fzf-make!
  • Execute the last executed command(By running fzf-make --repeat.)
  • Command history
  • Support make, pnpm. Scheduled to be developed: yarn, npm.
  • [make] Support include directive
  • [pnpm] Support workspace(collect scripts all of package.json in the directory where fzf-make is launched.)
  • (Scheduled to be developed) Support config file

👓 Prerequisites

  • (If you install fzf-make via a package manager other than Homebrew) bat
    • In the future, we intend to make it work with cat as well, but currently it only works with bat.

📦 Installation

macOS

Homebrew

You don't need to install bat because fzf-make will install it automatically via Homebrew.

# install
brew install kyu08/tap/fzf-make
# update 
brew update && brew upgrade fzf-make

Arch Linux

fzf-make can be installed from the AUR using an AUR helper. For example:

paru -S fzf-make

NixOS / Nix (package manager)

fzf-make can be run from the repository (latest version)

nix run github:kyu08/fzf-make

Or from the nixpkgs (channel >= 23.05)

nix run nixpkgs#fzf-make

Note You may need to enable experimental feature. In that case, execute the following command to enable them echo "experimental-features = nix-command flakes" | tee ~/.config/nix/nix.conf

OS-independent method

Cargo

cargo install --locked fzf-make

💡 Usage

Run target using fuzzy finder

  1. Execute fzf-make in the directory you want to run make target, or pnpm scripts.
  2. Select command you want to execute. If you type some characters, the list will be filtered. demo demo

Run target from history

  1. Execute fzf-make in the directory you want to run make target, or pnpm scripts.
  2. Press Tab to move to the history pane.
  3. Select command you want to execute. demo

How fzf-make judges which command runner can be used

make

Whether makefile(file name should be one of GNUmakefile, makefile, Makefile) is in the current directory.

pnpm

Whether package.json and pnpm-lock.yaml are in the current directory.

Commands Supported

Command Description
fzf-make Launch fzf-make
fzf-make --repeat / fzf-make -r / fzf-make repeat Execute last executed target
fzf-make --history / fzf-make -h / fzf-make history Launch fzf-make with the history pane focused
fzf-make --help / fzf-make help Show help
fzf-make --version / fzf-make -v / fzf-make version Show version

💻 Development

  1. Clone this repository
  2. Change the codes
  3. Run make run

To execute test, run make test(needs nextest).

nix

Or you can use nix to create a development shell with the project dependencies.

Within the repo root, execute the following command:

nix develop

👥 Contribution

  • Contributions are welcome!
  • If you have a Feature request, please create an issue first.
  • If you have added fzf-make to some package manager, please let me know. (or please send a PR to add how to install via the package manager in the README.md)
  • If you have any questions, feel free to create an issue and ask.

🗒 Related Article(s)