Modifier

Modifiers change the completion of macros and values. These can be set

The delimiter (|||) is currently very strict and not trimmed.

chdir

$chdir(<directory>) changes the directory.

["$files", "$chdir(/tmp)"]

The following macros can be passed as well instead of a static directory:

$gitdir .git folder
$gitworktree root of the working directory for a non-bare repository
$nixprofile ~/.nix-profile folder
$parent(\[file, dir\]) first parent directory containing any of the given names/directories
$tempdir default directory to use for temporary files
$usercachedir root directory to use for user-specific cached data
$userconfigdir default root directory to use for user-specific configuration data
$userhomedir current user's home directory
$xdgcachehome cache directory (fallback to UserCacheDir)
$xdgconfighome home directory (fallback to UserConfigDir)

["$files", "$chdir($gitdir)"]

$filter([<value>]) filters given values.

["one", "two", "three", "$filter([two])"]

$filterargs filters Context.Args.

["$files", "$filterargs"]

$list(<delimiter>) creates a list with given divider.

["one", "two", "three", "$list(,)"]

$multiparts([<delimiter>]) completes values splitted by given delimiter(s) separately.

["one/two/three", "$multiparts([/])"]

$nospace(<characters>) disables space suffix for given character(s).

["one", "two/", "three,", "$nospace(/,)"]

$pefix(<prefix>) adds a prefix to the inserted values.

["$files", "$prefix(file://)"]

$retain([<value>]) retains given values.

["one", "two", "three", "$retain([two])"]

$shift(<n>) shifts positional arguments left n times.

["one", "two", "three", "$filterargs", "$shift(1)"]

$split splits Context.Value lexicographically and replaces Context.Args with the tokens.

["one", "two", "three", "$filterargs", "$split"]

$splitp is like Split but supports pipelines.

["one", "two", "three", "$filterargs", "$splitp"]

$suffix(<suffix>) adds a suffix to the inserted values.

["apple", "melon", "orange", "$suffix(juice)"]

$suppress(<regex>) suppresses specific error messages using a regular expression.

["$message(fail)", "$suppress(fail)"]

$style(<style>) sets the style for all values.

["one", "two", "three", "$style(underlined)"]

$tag(<tag>) sets the tag for all values.

["one", "two", "three", "$tag(numbers)"]

$uniquelist(<delimiter>) creates a unique list with given divider.

["one", "two", "three", "$uniquelist(,)"]

$usage(<usage>) sets the usage message.

["$usage(custom)"]