Prerequisites#
Before using tabby-k8s-exec, make sure the following are in place.
1. A working kubeconfig file#
The plugin reads a kubeconfig file directly — by default ~/.kube/config,
though you can point it at any file in the profile settings. It does not
create or modify this file; it must already have at least one context
pointing at a cluster you can reach.
If you can already run kubectl get pods successfully against your
cluster, your kubeconfig is ready to use with this plugin as-is.
2. Credentials for your kubeconfig’s auth method#
The plugin resolves credentials using the same logic kubectl itself
uses, so whatever your kubeconfig already relies on continues to work
unchanged:
Static token / client certificate — nothing extra is needed.
``exec``-based auth plugins (used by managed clusters such as Amazon EKS, GKE, or any setup using
kubelogin) — the referenced binary (aws,gke-gcloud-auth-plugin,kubelogin, …) must be installed and available onPATH, and you must have an active, unexpired session with that provider at the moment you connect. For example, an EKS kubeconfig’sexecentry runsaws eks get-tokenunder the hood — if your AWS CLI session has expired, that command fails, and so does the connection. This is inherent to howexec-based auth works and applies equally to plainkubectl; the plugin cannot work around it.
Note
Once a token has been obtained, it is cached in memory for its stated
lifetime (an EKS token is normally valid for about 15 minutes), so the
underlying aws/gke-gcloud-auth-plugin/etc. command is not
re-run on every action — only when no valid cached token exists yet, or
the cached one has expired. Every new connection (opening a new tab)
starts with its own cache, though, so it can trigger a fresh credential
fetch even if another tab or the settings dialog already has one cached.
Once both are in place, continue to Installation.