fzf

package

v1.0.2 Latest Latest Go to latest Published: Mar 25, 2026 License: MIT Imports: 3 Imported by: 0

Details

This section is empty.

This section is empty.

func Run(lines []string, opts ...Option) (string, error)

Run launches fzf with the given lines and returns the selected line. Returns empty string and nil error if user cancelled (Esc/Ctrl-C).

func RunMulti(lines []string, opts ...Option) ([]string, error)

RunMulti launches fzf with multi-select enabled (TAB to toggle, Ctrl-A to select all). Returns nil, nil on cancel (Esc/Ctrl-C).

type ExpectResult struct {
	Query     string
	Key       string
	Selection string
}

func RunExpect(lines []string, opts ...Option) (*ExpectResult, error)

RunExpect launches fzf with --print-query and --expect, returning structured output. Returns nil, nil on cancel (Esc/Ctrl-C).

type Option func(*config)

func WithAnsi() Option

func WithBind(bindings ...string) Option

func WithExpectKeys(keys ...string) Option

func WithHeader(h string) Option

func WithNoSort() Option

func WithPreview(cmd, window string) Option

func WithPrintQuery() Option

func WithReverse() Option