Skip to main content

Shell Setup

Configure your shell for the best Kuve experience.

Basic Setup​

At minimum, you need to add Kuve's bin directory to your PATH. This is covered in the Installation guide, but here's a quick reference:

Bash​

export PATH="$HOME/.kuve/bin:$PATH"

Zsh​

export PATH="$HOME/.kuve/bin:$PATH"

Fish​

set -gx PATH "$HOME/.kuve/bin" $PATH

Shell Completion​

Enable tab completion for Kuve commands:

Bash Completion​

# System-wide
sudo kuve completion bash > /etc/bash_completion.d/kuve

# Current user
echo 'source <(kuve completion bash)' >> ~/.bashrc
source ~/.bashrc

Zsh Completion​

# Generate completion
kuve completion zsh > "${fpath[1]}/_kuve"

# Reload completions
autoload -U compinit && compinit

Fish Completion​

# Generate completion
kuve completion fish > ~/.config/fish/completions/kuve.fish

Verification​

Test your shell setup:

Test PATH​

# Verify kuve is in PATH
which kuve
# Expected: /home/username/.kuve/bin/kuve

# Verify kubectl symlink works
which kubectl
# Expected: /home/username/.kuve/bin/kubectl

Test Completion​

# Type and press TAB
kuve <TAB>
# Should show: install, uninstall, switch, list, use, init, etc.

Troubleshooting​

Completion Not Working​

  1. Verify completion is installed:

    # Bash
    ls /etc/bash_completion.d/kuve

    # Zsh
    ls ${fpath[1]}/_kuve

    # Fish
    ls ~/.config/fish/completions/kuve.fish

  2. Reload shell:

    exec $SHELL

Next Steps​