https://github.com/kyu08/fzf-make
A command line tool that executes commands using fuzzy finder with preview window for make, pnpm, yarn, just.
https://github.com/kyu08/fzf-make
cli crates-io fuzzy-finder fzf hacktoberfest just make makefile pnpm ratatui rust terminal tui
Last synced: 4 days ago
JSON representation
A command line tool that executes commands using fuzzy finder with preview window for make, pnpm, yarn, just.
- Host: GitHub
- URL: https://github.com/kyu08/fzf-make
- Owner: kyu08
- License: mit
- Created: 2023-03-08T17:26:51.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-09T17:26:58.000Z (5 days ago)
- Last Synced: 2025-04-09T18:39:14.084Z (5 days ago)
- Topics: cli, crates-io, fuzzy-finder, fzf, hacktoberfest, just, make, makefile, pnpm, ratatui, rust, terminal, tui
- Language: Rust
- Homepage:
- Size: 30 MB
- Stars: 158
- Watchers: 3
- Forks: 13
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-rust - fzf-make - make](https://crates.io/crates/fzf-make)] - A command line tool that executes make target using fuzzy finder with preview window. [](https://crates.io/crates/fzf-make) (Development tools / Web Servers)
- awesome-ratatui - fzf-make - A command line tool that executes make target using fuzzy finder with preview window. (💻 Apps / 🚀 Productivity and Utilities)
- fucking-awesome-rust - fzf-make - make](crates.io/crates/fzf-make)] - A command line tool that executes make target using fuzzy finder with preview window. [](https://crates.io/crates/fzf-make) (Development tools / Web Servers)
- fucking-awesome-rust - fzf-make - make](crates.io/crates/fzf-make)] - A command line tool that executes make target using fuzzy finder with preview window. [](https://crates.io/crates/fzf-make) (Development tools / Web Servers)
- awesome-rust - fzf-make - make](https://crates.io/crates/fzf-make)] — A command line tool that executes make target using fuzzy finder with preview window. [](https://crates.io/crates/fzf-make) (Development tools / Web Servers)
README
`fzf-make` is a command line tool that executes commands using fuzzy finder with preview window. Currently supporting [**make**](https://www.gnu.org/software/make/), [**pnpm**](https://github.com/pnpm/pnpm), [**yarn**](https://github.com/yarnpkg/berry), [**just**](https://github.com/casey/just).
[](https://github.com/kyu08/fzf-make/releases/latest)
[](https://crates.io/crates/fzf-make)
[](https://crates.io/crates/fzf-make)
# 🛠️ Features
- Select and execute a make target or (pnpm | yarn) scripts or just recipe 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**](https://www.gnu.org/software/make/), [**pnpm**](https://github.com/pnpm/pnpm), [**yarn**](https://github.com/yarnpkg/berry), [**just**](https://github.com/casey/just). **Scheduled to be developed: npm.**
- [make] Support `include` directive
- [pnpm] Support workspace(collect scripts all of `package.json` in the directory where fzf-make is launched.)
- [yarn] Support workspace(collect all scripts which is defined in `workspaces` field in root `package.json`.)
- [just] Support execution inside of directory of justfile.
- **(Scheduled to be developed)** Support config file
# 📦 Installation
## macOS
### Homebrew
```sh
# install
brew install fzf-make
```
```sh
# update
brew upgrade fzf-make
```
## Arch Linux
`fzf-make` can be installed from the [AUR](https://aur.archlinux.org/packages/fzf-make) using an [AUR helper](https://wiki.archlinux.org/title/AUR_helpers). For example:
```sh
paru -S fzf-make
```
## NixOS / Nix (package manager)
`fzf-make` can be run from the repository (latest version)
```sh
nix run github:kyu08/fzf-make
```
Or from the nixpkgs (channel >= 23.05)
```sh
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
```sh
cargo install --locked fzf-make
# Or build from HEAD
cargo install --git https://github.com/kyu08/fzf-make/
```
# 💡 Usage
## Run target using fuzzy finder
1. Execute `fzf-make` in the directory you want to run make target, or (pnpm | yarn) scripts or just recipe.
1. Select command you want to execute. If you type some characters, the list will be filtered.
## Run target from history
1. Execute `fzf-make` in the directory you want to run make target, or (pnpm | yarn) scripts or just recipe.(For just, we support execution inside of directory of justfile.)
1. Press `Tab` to move to the history pane.
1. Select command you want to execute.
## 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.
### yarn
Whether `package.json` and `yarn.lock` are in the current directory.
### just
Whether `justfile` or `.justfile` are in the current directory or ancestor directories. If the lower cased file name matches `justfile` or `.justfile`, it is treat as a justfile. (e.g. `justFile` or `.JustFile` are also valid.)
## 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 |
## Example Aliases
To simplify the usage of `fzf-make`, you can define aliases in your shell configuration. Below is an example configuration that works for most shells (bash, zsh, fish, etc.):
```sh
alias fm='fzf-make'
alias fr='fzf-make repeat'
alias fh='fzf-make history'
```
# 💻 Development
1. Clone this repository
1. Change the codes
1. 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
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)
- [fzf-make - A command runner with fuzzy finder and preview window for make, pnpm - reddit](https://www.reddit.com/r/commandline/comments/1h7btkl/fzfmake_a_command_runner_with_fuzzy_finder_and/)
- [Show HN: fzf-make – a command runner with a fuzzy finder for make, pnpm and yarn - Hacker News](https://news.ycombinator.com/item?id=42357587)
- (Japanese)[[make,pnpm,yarnに対応]タスクランナーのコマンドをfuzzy finder形式で選択できるCLIツール fzf-makeの紹介](https://zenn.dev/kyu08/articles/974fd8bc25c303)
- (Japanese)[Makefileに定義されたtargetをfzfで選択して実行するCLIツールをRustでつくった](https://blog.kyu08.com/posts/fzf-make)