🛰️ teleconnect

A lightweight CLI utility for quickly establishing a Telepresence connection to a Kubernetes namespace. It reads your current context form kubeconfig and connects Telepresence to the corresponding namespace — making local debugging and development against remote clusters effortless.

Requirements

Install teleprecence client: https://telepresence.io/docs/install/client

Installation

curl -L -o teleconnect.tar.gz https://github.com/iapershin/teleconnect/releases/download/<VERSION>/teleconnect-<OS>-<PLATFORM>.tar.gz
tar -xzf teleconnect.tar.gz -C <INSTALL_PATH>

OR

go install github.com/iapershin/teleconnect/cmd/teleconnect@latest

Features

• Automatically detects your current Kubernetes context and namespace

• Optionally allows specifying:

  • A different cluster or namespace
  • A custom kubeconfig file
  • Additional CIDR ranges for proxying traffic (--also-proxy)

• Gracefully handles existing Telepresence sessions before reconnecting

Usage

teleconnect [flags]

Flags

Flag	Short	Description	Default
--kubeconfig	-k	Path to kubeconfig file	$KUBECONFIG or ~/.kube/config
--namespace	-n	Kubernetes namespace	From current context
--cluster	-c	Kubernetes cluster name	From current context
--also-proxy		Additional CIDR to proxy	---

Example:

teleconnect -n dev -c staging --also-proxy 192.168.0.0/16