hub / github.com/telepresenceio/telepresence
github.com/telepresenceio/telepresence @v2.29.1
Chat with this repo
7,055 symbols
28,361 edges
625 files
1,498 documented · 21%
111 cross-repo links
● updated 5d agov2.29.2 · 2026-07-04★ 7,2498 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
Telepresence: Fast, Local Development for Kubernetes
Telepresence is a CNCF project that connects your local workstation to a remote Kubernetes cluster, letting you run services locally while accessing cluster resources. It enables fast local development without the container build/push/deploy cycle.
Key Features
- Local Development - Run services on your workstation using your favorite IDE, debugger, and tools
- Cluster Access - Your local machine can reach cluster services as if it were inside the cluster
- Traffic Interception - Redirect traffic from cluster services to your local machine for debugging
- Fast Iteration - No waiting for container builds or deployments
Getting Started
- Quick Start Guide - Get up and running in minutes
- Installation - Install the Telepresence client
- Documentation - Full documentation
How It Works
When Telepresence connects to a cluster, it creates a virtual network interface on your workstation and routes traffic through a Traffic Manager deployed in the cluster. This allows your local services to communicate with cluster resources and optionally intercept traffic destined for cluster workloads.
Community
- CNCF Slack - Join #telepresence-oss
- Troubleshooting - Common issues and solutions
Contributing
See CLAUDE.md for build instructions, architecture overview, and development guidelines.
License
Telepresence is licensed under the Apache License 2.0.
Extension points exported contracts — how you extend this code
Mounter (Interface)
A Mounter is responsible for mounting a remote filesystem in a local directory or drive letter. [14 implementers]
pkg/client/remotefs/mounter.go
Provider (Interface)
(no doc) [11 implementers]
pkg/tunnel/provider.go
Exe (Interface)
Exe is an abstraction of the executable related functions with the same name in the os package. [3 implementers]
pkg/dos/exe.go
WriterTos (Interface)
WriterTos implements something that can be represented as a list of io.WriterTo. [3 implementers]
pkg/ioutil/writeallto.go
Sink (Interface)
Sink is the FIFO buffer holding reports between production and transmission. Implementations must be safe for concurrent [2 …
pkg/usg/producer.go
AgentState (Interface)
(no doc) [4 implementers]
pkg/restapi/api.go
Workload (Interface)
(no doc) [4 implementers]
pkg/k8sapi/workload.go
Value (Interface)
Value comes in three flavors. One that performs an exact match against a string, one that uses a regular expression, and [1 …
pkg/matcher/value.go
Core symbols most depended-on inside this repo
Errorf
called by 809
pkg/errcat/errors.go
NoError
called by 723
integration_test/http_intercepts_test.go
Error
called by 522
pkg/grpc/error.go
Contains
called by 358
integration_test/http_intercepts_test.go
Context
called by 310
integration_test/itest/suite.go
Equal
called by 284
pkg/client/config.go
Require
called by 275
integration_test/itest/suite.go
New
called by 264
pkg/errcat/errors.go
Shape
Languages
Go100%
Modules by API surface
rpc/manager/manager.pb.go598 symbols
rpc/connector/connector.pb.go251 symbols
rpc/connector/connector_grpc.pb.go191 symbols
rpc/manager/manager_grpc.pb.go186 symbols
rpc/daemon/daemon.pb.go180 symbols
pkg/client/config.go177 symbols
integration_test/itest/cluster.go102 symbols
rpc/daemon/daemon_grpc.pb.go101 symbols
pkg/k8sapi/workload.go83 symbols
pkg/client/cli/docker/compose/extension.go79 symbols
cmd/traffic/cmd/manager/service.go73 symbols
pkg/dos/filesystem.go71 symbols
Dependencies from manifests, versioned
dario.cat/mergov1.0.2 · 1×
github.com/Azure/go-ansitermv0.0.0-2025010203350 · 1×
github.com/BurntSushi/tomlv1.6.0 · 1×
github.com/MakeNowJust/heredocv1.0.0 · 1×
github.com/Masterminds/goutilsv1.1.1 · 1×
github.com/Masterminds/semver/v3v3.5.0 · 1×
github.com/Masterminds/sprig/v3v3.3.0 · 1×
github.com/Masterminds/squirrelv1.5.4 · 1×
github.com/Microsoft/go-winiov0.6.2 · 1×
github.com/ProtonMail/go-cryptov1.4.1 · 1×
github.com/VividCortex/ewmav1.2.0 · 1×
github.com/acarl005/stripansiv0.0.0-2018011610285 · 1×
For agents
$ claude mcp add telepresence \
-- python -m otcore.mcp_server <graph>