fzf-zsh-completions

Fuzzy completions for fzf and Zsh that can be triggered by the trigger sequence that defaults to **.

Prerequisites

fzf >= 0.21.1
Zsh >= 5.1
jq >= 1.5
awk

The following dependencies are optional unless those completions are desired:

docker CLI >= 17.03.0 (for docker completions)
git >= 2.7.1 (for git completions)

Installation

Load fzf-zsh-completions.plugin.zsh.

For those who prefer to install via package managers, see the instructions below. Be sure to load the plugin after alias calls for aliased completions to work.

Antigen

antigen bundle "chitoku-k/fzf-zsh-completions"

zplug

zplug "chitoku-k/fzf-zsh-completions"

Usage

For further information, please refer to Fuzzy completions for bash and zsh.

git rebase -i **<TAB>

Supported commands

cf
- Apps/App instances/Tasks/...
- Domains/Routes/...
- Files
- Marketplace/Service brokers/Service instances/...
- Orgs/Spaces/...
composer
- Scripts
docker
- Containers/Images/Networks/Volumes
- Files
- Repositories
gh
- Pull Requests
git
- Commit-ish
- Commit messaees
- Files
- Remotes
kubectl
- Annotations/Labels/Field selectors
- Containers/Ports
- Files
- Resources
- Taints
make
- Targets
npm
- Scripts
systemctl
- Services
vault
- Paths
yarn
- Scripts

Extension

In order to add/override completions for subcommands to the existing completion, define a function as in the following:

# This function implements `kubectl view-serviceaccount-kubeconfig **`
# Function name must be _fzf_complete_(command)_(subcommand)
_fzf_complete_kubectl_view-serviceaccount-kubeconfig() {
    # Call preprocessors
    _fzf_complete_kubectl_parse_resource_and_name 2
    _fzf_complete_kubectl_parse_completing_option
    _fzf_complete_kubectl_parse_kubectl_arguments

    # Return status code other than 0 to fall back to default
    if [[ -n $completing_option ]]; then
        return 1
    fi

    # Call any one of completion functions; see source code as to their usage
    resource=serviceaccounts
    _fzf_complete_kubectl-resource-names '' "$@"
}

Testing

For contributing to this project, be sure to update tests/ and run following:

tests/test.zsh

Related Project

fzf-preview.zsh