Categorygithub.com/tty2/kubic
repositorypackage
0.0.4
Repository: https://github.com/tty2/kubic.git
Documentation: pkg.go.dev

# Packages

No description provided by the author

# README

kubic

tui for k8s

What is it.

kubic is a tui k8s explorer.

The idea is to free from the need to keep namespaces, deployments, pods names in your head.

It's a good replacement for kubectl or more precisely it's an additional tool that takes over the most of work.

Features

  • doesn't require configuration for start, just kubernetes config
  • vim mappings + arrows for navigation
  • simple, sweet design powered by Charm libraries

UI screenshots

Different color scheme example.

Info deployments (implemented with v0.0.2)

Requirements

  • kubernetes config file

The best way is to keep it in ~/.kube/config path. But you can set path on running.

Installation

From release

  • Download archive from Releases
  • Extract archive
chmod +x kubic
mv kubic ~/.local/bin

Unfortunately I don't have apple developer account currently, so binary for mac os have problems with gatekeeper. Try build manually (next way).

Build manually

git clone [email protected]:tty2/kubic.git
go build

Put kubic binary to your favorite */bin path (Check with echo $PATH).

Run

  1. With default config.

You can run kubic without any parameters if you have kubernetes config in ~/.kube/config path nad need to use it.

kubic
  1. With custom config.

You can run it with --config or shot -c parameter and set path to the config path. Or with environment variable KUBIC_KUBERNETES_CONFIG_PATH.

kubic -c /path/to/the/config/file
  1. With custom color scheme.

If you want's to use different color scheme, put style.json in the same directory with kubic binary and run kubic without additional parameters. kubic will use this file automatically.

You can set path path to your json file with --theme parameter (short way -t) or with environment variable KUBIC_THEME_FILE_PATH.

kubic -t /path/to/the/json/style/file

Flags list:

Short FlagLong FlagEnvironment VariableIs RequiredTypeDefault
-c--configKUBIC_KUBERNETES_CONFIG_PATHFalsestring
-t--themeKUBIC_THEME_FILE_PATHFalsestring
-l--log_tailKUBIC_LOG_TAIL_LINESFalseint100

Customization

You can set your own color scheme with json file.

Example

Classes are predefined. Set your own color with hex.

{
    "main-text": "#ffffff",
    "selected-text": "#61b0de",
    "inactive-text": "#616363",
    "tab-borders": "#109f93",
    "namespace-sign": "#eb24a9"
}

Powered by Charm.

The Charm logo