|
| 1 | +--- |
| 2 | +title: About remote control of {% data variables.copilot.copilot_cli %} sessions |
| 3 | +shortTitle: About remote control |
| 4 | +intro: 'Remote control lets you monitor and steer a {% data variables.copilot.copilot_cli_short %} session from {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_mobile %}, even after you''ve stepped away from your machine.' |
| 5 | +versions: |
| 6 | + feature: copilot |
| 7 | +redirect_from: |
| 8 | + - /copilot/concepts/agents/copilot-cli/about-remote-access |
| 9 | +contentType: concepts |
| 10 | +category: |
| 11 | + - Learn about Copilot # Copilot discovery page |
| 12 | + - Learn about Copilot CLI # Copilot CLI bespoke page |
| 13 | +docsTeamMetrics: |
| 14 | + - copilot-cli |
| 15 | +--- |
| 16 | + |
| 17 | +This article explains the concepts around remote control of {% data variables.copilot.copilot_cli_short %} sessions. For instructions on how to enable remote control, see [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli/steer-remotely). |
| 18 | + |
| 19 | +## When remote control helps |
| 20 | + |
| 21 | +By default, {% data variables.copilot.copilot_cli %} sessions are only steerable from your local machine. However, you can enable remote control of the session. Remote control is useful when you want to view progress or respond to prompts and permission requests, without having to remain at the machine where the session is running. For example: |
| 22 | + |
| 23 | +* **You step away from your workstation**: Keep interacting with {% data variables.product.prodname_copilot_short %} from your phone or another device, without returning to the machine where the session is running. |
| 24 | +* **A long-running task needs your input**: Approve permission requests and answer questions as they come up, so the task isn't blocked while you're away. |
| 25 | +* **You want a quick status check**: Glance at session progress from {% data variables.product.prodname_mobile %} while you work on something else. |
| 26 | + |
| 27 | +## Prerequisites |
| 28 | + |
| 29 | +Remote control requires: |
| 30 | + |
| 31 | +* **Policy enablement**: If your {% data variables.product.prodname_copilot_short %} seat comes from an organization, an enterprise or organization owner must enable the "Remote Control" policy (off by default). See [Administering remote control](#administering-remote-control) later in this article. |
| 32 | +* **The machine must be online**: The CLI session must be actively running in a terminal on a machine with an internet connection. If the machine goes to sleep or loses its connection, remote control is unavailable until the machine is back online. See [Reconnection](#reconnection) later in this article. |
| 33 | +* **An interactive session**: Remote access is only available for interactive sessions. It is not available when you use the CLI programmatically with the `--prompt` command-line option, for example when you use the CLI in a script. |
| 34 | + |
| 35 | +## Accessing a session remotely |
| 36 | + |
| 37 | +When you enable remote control for a {% data variables.copilot.copilot_cli_short %} session, you can go to {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_mobile %} and find the session in the list of your recent agent sessions. The remote interface is updated in real time, allowing you to monitor ongoing output from the session and respond to prompts and permission requests as they come in. |
| 38 | + |
| 39 | +Both the local terminal and the remote interface are active at the same time. You can enter commands in either interface. {% data variables.copilot.copilot_cli_short %} uses the first response it receives to any prompt or permission request. |
| 40 | + |
| 41 | +Your session continues to run on your local machine. The remote interface provides a way to interact with the session, but the CLI itself—and all the tools, shell commands, and file operations it runs—remain on the machine where you started the session. |
| 42 | + |
| 43 | +## What you can do remotely |
| 44 | + |
| 45 | +When connected to a session remotely from {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_mobile %}, you can: |
| 46 | + |
| 47 | +* **Respond to permission requests**: Approve or deny tool, file path, and URL permission requests. |
| 48 | +* **Respond to questions**: Answer when {% data variables.product.prodname_copilot_short %} asks you to supply more information or make a decision. |
| 49 | +* **Approve or reject plans**: Respond to plan approval prompts when {% data variables.product.prodname_copilot_short %} is in plan mode. |
| 50 | +* **Submit new prompts**: Enter questions or instructions, just as you would in the terminal. |
| 51 | +* **Switch modes**: Change the session mode—for example, between interactive and plan mode. |
| 52 | +* **End the current operation**: Cancel the agent's current work. |
| 53 | + |
| 54 | +{% data reusables.cli.remote-access-slash-commands %} |
| 55 | + |
| 56 | +## Reconnection |
| 57 | + |
| 58 | +If the connection between your local machine and {% data variables.product.prodname_dotcom %} is temporarily lost—for example, due to a network interruption—you can continue using the session remotely as soon as the connection is restored. |
| 59 | + |
| 60 | +You can use the `/keep-alive` slash command to prevent your machine from going to sleep. See [Preventing your machine from going to sleep](/copilot/how-tos/copilot-cli/use-copilot-cli/steer-remotely#preventing-your-machine-from-going-to-sleep). |
| 61 | + |
| 62 | +{% data reusables.cli.remote-access-reconnection %} |
| 63 | + |
| 64 | +## Security and privacy |
| 65 | + |
| 66 | +Remote control is only available to you — the person signed in to {% data variables.product.prodname_dotcom %} with the same account that started the CLI session. No one else can view or interact with your sessions remotely. The session URL displayed in the CLI is session-specific and only accessible to authenticated users with the correct account. |
| 67 | + |
| 68 | +When remote control is enabled: |
| 69 | + |
| 70 | +* Session events (conversation messages, tool execution events, and permission requests) are sent from your local machine to {% data variables.product.prodname_dotcom %}. |
| 71 | +* Remote commands are polled by {% data variables.copilot.copilot_cli_short %} from {% data variables.product.prodname_dotcom %} and injected into your local session. |
| 72 | +* The CLI continues to run locally — all shell commands, file operations, and tool executions happen on your machine. Remote control does not grant direct access to your machine beyond what the CLI agent can do within the session. |
| 73 | + |
| 74 | +The remote session link (displayed in the CLI when you enable remote control) points to a session-specific URL on {% data variables.product.prodname_dotcom_the_website %}. Only authenticated users with the correct account can access this URL. |
| 75 | + |
| 76 | +## Administering remote control |
| 77 | + |
| 78 | +Enterprise and organization owners control whether users can enable remote control, using the "Remote Control" policy. This policy is off by default. |
| 79 | + |
| 80 | +For more information, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies) and [AUTOTITLE](/copilot/how-tos/copilot-cli/administer-copilot-cli-for-your-enterprise). |
0 commit comments