korrect

A CLI tool to manage (and optionally fetch) multiple different versions of kubectl by providing a shim layer on top of kubectl. Based on the current k8s context, the correct kubectl version will automatically be invoked. Correct Kubetctl. Korrect.

Witness the miracle of never again needlessly being admonished: version difference between client (1.31) and server (1.29) exceeds the supported minor version skew of +/-1

Features

• Easy installation with automatic setup of required directories and symlinks
• Optional automated download of kubectl, or keep it entirely manual.
• Shell completion support for various shells (bash, zsh, fish)
• Low performance overhead via caching based on kubeconfig content
• Supports common kubectl aliases (k and kubectl)
• Can uninstall itself: Satisfaction guaranteed or just call korrect setup --uninstall.

Installation

From Source

git clone https://gitlab.com/cromulentbanana/korrect.git
cd korrect
cargo install --path .

Using Cargo

cargo install korrect

Download binaries from gitlab release

1. Visit https://gitlab.com/cromulentbanana/korrect/-/releases
2. Download korrect and korrect-shim and place into the same directory (of your choice) in your shell's path

Quick Start

1. Install korrect:

korrect setup

2. Add the korrect bin directory to your PATH:

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

3. Start using kubectl as normal - korrect will automatically intercept and process your commands.

Usage

Basic Commands

# Set up korrect
korrect setup

# List installed components
korrect list

# Generate shell completions (replace `zsh` with your shell)
korrect completions zsh

Setup Options

The setup command supports several flags to customize installation:

# Force installation (overwrite existing files)
korrect setup --force

# Uninstall korrect
korrect setup --uninstall

Directory Structure

After installation, korrect creates the following directory structure:

~/
├──.cache/korrect/     # The contents of the active kubeconfig are hashed to reference
├                      # the version-specific kubectl belonging to it 
└──.korrect/bin/
    ├── k              # Symlink to kubectl-shim
    ├── kubectl        # Symlink to kubectl-shim
    ├── kubectl-shim   # The executable which dispatches specific kubectl versions
    ├── kubectl-vA.B.C # Binary auto-downloaded by kubectl-shim or placed here by you
    └── kubectl-vX.Y.Z # Binary auto-downloaded or kubectl-shim or placed here by you

Configuration

Coming Soon: Configuration files can be placed in ~/.config/korrect/config.toml. Example configuration:

[korrect]
key = value

[korrect-shim]
korrect_dir = ~/.some_other_dir
auto_download = true

Shell Completion

korrect supports shell completions for various shells. To enable completions:

# For bash
korrect completions bash > ~/.local/share/bash-completion/completions/korrect

# For zsh
korrect completions zsh > ~/.zfunc/_korrect

# For fish
korrect completions fish > ~/.config/fish/completions/korrect.fish

Remember to source your shell's completion file or restart your shell.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Acknowledgments

• Inspired by the volta.sh the Hassle-free javascript tool manager
• Built with clap-rs for argument parsing, shell completion