Search the Docs

Client Reference

The Telepresence CLI client is used to connect Telepresence to your cluster, start and stop intercepts, and create preview URLs. All commands are run in the form of telepresence <command>.


A list of all CLI commands and flags is available by running telepresence help, but here is more detail on the most common ones.

connectStarts the local daemon and connects Telepresence to your cluster and installs the Traffic Manager if it is missing. After connecting, outbound traffic is routed to the cluster so that you can interact with services as if your laptop was another pod (for example, curling a service by it's name)
loginAuthenticates you to Ambassador Cloud to create, manage, and share preview URLs
logoutLogs out out of Ambassador Cloud
dashboardReopens the Ambassador Cloud dashboard in your browser
previewCreate or remove preview domains for existing intercepts
statusShows the current connectivity status
quitQuits the local daemon, stopping all intercepts and outbound traffic to the cluster
listLists the current active intercepts
interceptIntercepts a service, run followed by the service name to be intercepted and what port to proxy to your laptop: telepresence intercept <svc name> --port <TCP port>. This command can also start a process so you can run a local instance of the service you are intercepting. For example the following will intercept the hello service on port 8000 and start a Python web server: telepresence intercept hello --port 8000 -- python3 -m http.server 8000
leaveStops an active intercept, for example: telepresence leave hello
uninstallUninstalls Telepresence from your cluster, using the --agent flag to target the Traffic Agent for a specific deployment, the --all-agents flag to remove all Traffic Agents from all deployments, or the --everything flag to remove all Traffic Agents and the Traffic Manager.


We’re here to help. If you have questions, join our Slack or contact us.