MHmorgan/selector

Simple terminal application which lets the user select between its input arguments and prints out the the selected choice.

Selector

Simple terminal application which lets the user select between its input arguments and prints out the selected choice.

The usage is simple and intuitive: use the arrow keys to move between values; press enter to select a value; type / to start filtering.

Intended to be used in shell functions and aliases, such as:

alias goto='cd $(selector $HOME/*)'

# or

function goto {
	local DIR=$(selector $HOME/*)/$1
	cd $DIR
	ls
}

Startup filtering

Parameter -filter applies a filter to the list of choices at startup.
This is useful when the list of choices is long and the user wants to filter it down to a few choices before selecting one.

If the filter matches exactly one choice, it is automatically selected and printed.
This allows implementing a goto shell function which will automatically switch to a directory if the sufficient filter is provided by the user. With the function below, calling goto foo will automatically switch to the $HOME/Documents/foodir directory.

#!/bin/zsh

function goto {
	mypaths=(
		$HOME/{Documents,Downloads}
		$HOME/Documents/foodir
	)
	local DIR=$(selector -filter "$*" ${=mypaths})
	# Don't try to change directory if selector didn't return a value
	[[ -n "$DIR" ]] || return
	echo $DIR
	cd $DIR
	ls
}

Installation

go install github.com/mhmorgan/selector@latest