fzf

package

v1.2.0 Latest Latest Go to latest Published: Apr 15, 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 WithCycle() Option

func WithDelimiter(d string) Option

func WithExpectKeys(keys ...string) Option

func WithHeader(h string) Option

func WithNoSort() Option

func WithNth(n string) Option

func WithPreview(cmd, window string) Option

func WithPrintQuery() Option

func WithQuery(q string) Option

func WithReverse() Option