fzf-ecma is a monorepo containing JavaScript bindings (with TypeScript support) for the popular golang fzf fuzzy finder. It currently includes implementations for Bun and Node.js.

Why wrap a golang library? Why not rewrite it in JavaScript?

1. That would take a lot of work
2. fzf is Blazingly fast ™️
3. fzf is very well maintained

Note: All packages in this repository require fzf to be installed on your system and available in your PATH.

See each package's README for specific installation and usage details.

Package	Latest	Changelog
fzf-node		Changelog
fzf-bun		Changelog
fzf-deno	TODO

Simply provide fzf with an array of strings and an array of fzf options. When this script is executed, it will spawn fzf as a child process in your SHELL. For all available fzf options see the fzf docs.

import { fzf } from 'fzf-bun'

// Run `man fzf` in your shell to see all available fzf options
const fzfOptions = ['--multi', '--preview-window=up', '--preview', 'echo {}']

const selections = ['Pen ✒️', 'Pineapple 🍍', 'Apple 🍎', 'Pen ✒️']

const selection = await fzf(selections, fzfOptions)

// Do something with selection
console.log(selection)

Contributions are welcome! Please read the contributing guidelines before submitting pull requests or opening issues.

MIT