MCPcopy
hub / github.com/telepresenceio/telepresence

github.com/telepresenceio/telepresence @v2.29.1 sqlite

repository ↗ · DeepWiki ↗ · release v2.29.1 ↗
7,055 symbols 28,361 edges 625 files 1,498 documented · 21%
README

Telepresence: Fast, Local Development for Kubernetes

Artifact Hub Gurubase

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

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

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

Method 4,269
Function 1,887
Struct 651
Interface 128
TypeAlias 102
FuncType 18

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/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>

⬇ download graph artifact