Reticle/ Docs Get Desktop
Documentation/Connect and operate
On this page

Desktop terminals

On macOS and Linux, Desktop can open an interactive SSH or Kubernetes shell beside the diagram. These are live operator sessions, not read-only inspection. Windows Desktop and Team browsers do not support interactive terminals.

Open an SSH session#

  1. Use a node kind with an SSH target, such as Server or Application.
  2. In the Inspector, enter host, SSH port, and user. Choose Save details.
  3. Enable privileged mode for the workspace.
  4. Choose Shell and confirm the live-shell warning.

Reticle invokes the local ssh program and uses your OpenSSH configuration. The shell runs on the remote host. A container-shaped node does not automatically enter a Docker container; its SSH target is still the configured host.

Open a Kubernetes session#

Configure the Kubernetes node's context, namespace, and name. Reticle uses local kubectl and kubeconfig to list candidate pods and open a selected pod. The terminal runs kubectl exec -it … -- /bin/sh; the container must contain that shell.

Kubernetes node kinds do not install collectors or discover a topology. Pod selection supports the interactive workflow only.

Close sessions#

Close the terminal tab when finished. Switching workspaces, revoking privileged mode, or quitting Desktop closes its terminal sessions. Trust for a previously enabled workspace remains until revoked or the app exits; see workspaces.

For a repeatable task with approval and a timeout, use a named action instead.

View Markdown Report a docs issue
Reticle documentationDraw intentionally. Operate with context.

↑ ↓ to move · Enter to open · Esc to close