> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/automation-api-and-sdks/browser-remote-control.md).

# Browser remote control

What the "Allow browser remote control" setting does, what Cas and scripts can do with it, and how to turn it off.

Open **Settings** in the left-side menu, click the **Automation** tab and find **Browser remote control**. The **Allow browser remote control** switch is on by default.

When it is on, every browser profile you launch opens a private connection on your own computer (`127.0.0.1`). Incogniton and Cas, the AI assistant in the app, use that connection to work inside your running profiles. Other computers cannot reach it.

<div data-with-frame="true"><figure><img src="https://1094567560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH8yXxFJjKNEduZ4cdtjg%2Fuploads%2Fgit-blob-ef3810641824119c0225aa0a8bd1ec311748aaf2%2Fv5-settings-automation-remote-control.png?alt=media" alt="Settings, Automation tab: Allow browser remote control"><figcaption></figcaption></figure></div>

### What remote control makes possible

With **Allow browser remote control** on, you can ask Cas to:

* Open a URL in a running profile, navigate, or refresh the page.
* Switch to a tab, close a tab, or close all other tabs.
* Wait until a profile is running or stopped, and stop a profile.
* Delete a profile.
* Restore a profile from a cloud backup or a local backup, or do a full reset of a profile. Cas shows the available backups in the chat and only starts once you confirm.

AI clients connected through [MCP](https://docs.incogniton.com/automation-api-and-sdks/connect-ai-clients-mcp.md) also need this setting to get the local DevTools address of a profile they launched, so a script on the same computer can attach Puppeteer or Playwright to it.

### What still works when it is off

With the switch off, launched browsers are not controllable. Cas can still:

* Check whether a profile's proxy works.
* Start and stop your cloud phones.

Everything else in the list above is unavailable until you turn the switch back on. The switch does not turn off the [local REST API](https://docs.incogniton.com/automation-api-and-sdks/local-rest-api.md); that has its own switch on the same tab.

### Turn it on or off

{% stepper %}
{% step %}

#### Open the Automation tab

Click **Settings** in the left-side menu, then click the **Automation** tab.
{% endstep %}

{% step %}

#### Change the switch

Turn **Allow browser remote control** on or off, then click **Save** in the bar at the bottom of the screen.
{% endstep %}

{% step %}

#### Relaunch your profiles

The change applies to profiles you launch after saving. Profiles that are already running keep their current setting until you stop and start them again.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
If a profile has its own `--remote-debugging-port` in its custom browser arguments, Incogniton uses that port instead and does not add its own connection.
{% endhint %}
