For blazingly fast kubernets ops
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


kubemrr mirrors description of Kubernetes resources for blazingly fast auto-completion.

Feel free to suggest improvements, I'm here to work on them 👍

Build Status


Bash has the programmable completion feature which permits typing a partial command, then pressing the [TAB] key to auto-complete the command sequence.To use the feature, you need to write a completion script and place it in /etc/bash_completion.d folder (docs, tutorial). Fortunately, kubectl comes with a command to generate completion script (kubectl completion). The script works extremely well, but slow, because each time you hit [TAB] it sends a request to Kubernetes API Server. If your server is on a different continent you might wait for up to 2 seconds. To reduce the delay, kubemrr keeps names of resources locally. See how to make a completion script which talks to kubemrr instead of real Kubernetes API server in the example below.



To start watching servers, give context names from your kubeconfig file:

kubemrr watch dev prod

To make completion script that talks to kubemrr shell:

alias kus='kubectl --context us'
kubemrr completion bash --kubectl-alias=kus > kus
sudo cp kus /etc/bash_completion.d

Note that you need to have bash completion installed. It shoud be available on a Linux distribution. On a Mac, install with brew install bash-completion.

Replace bash with zsh in the above command to generate completion script for zsh shell.

To test it:

source kus
kus get po [TAB][TAB]
kus get svc [TAB][TAB]
kus get deployments [TAB][TAB]
kus get configmaps [TAB][TAB]
kus get namespaces [TAB][TAB]
kus get nodes [TAB][TAB]

To make completion script that talks to kubemrr that is running on different host (use IP to save time on name resolution):

kubemrr completion bash --address= --kubectl-alias=kus > kus


  • OSX:
curl -O
  • Linux:
curl -O