# 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](workspaces.md#switch-workspaces).

For a repeatable task with approval and a timeout, use a
[named action](checks-and-actions.md#define-and-run-a-named-action) instead.
