> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enconvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Your Other Computers

> Pair your computers that run Enconvo, then use one's chats, terminal, screen and agents from another while the work keeps running there.

Pair two computers that run Enconvo and you can work on one from the other. A chat you open on a paired computer runs there, with that computer's files, keys, models and agents, and keeps running when you look away. You can also watch or control its screen, send it files, and let your agent here hand work to it.

To reach a server that doesn't run Enconvo, add it as an SSH host instead. See [Computers and SSH Hosts](https://docs.enconvo.ai/integrations/computers-and-ssh-hosts.md).

## Before you start

* Install Enconvo on both computers and sign them in to the same Enconvo account.
* Keep both online with Enconvo running. A computer can be reached only while Enconvo runs there.
* On the Free plan you can pair one computer with another. The account's Device seat stays on one of the two: you can work on that one from the other, while from it you can read the other computer's chats and send it files.

## Pair a computer

Pairing always shows which computer controls and which is controlled. You can start it from either side.

**1. Start pairing**

Click the device switcher at the bottom of the Chat Window sidebar, then **Add a device → Pair a computer**. Or open **Settings → Connections** and click **Pair a computer** under **Computers**.

**2. Pick the computer to control**

Your other computers that are online show in the list. Pick the one you want to control from this one, and choose what it may reach. To control it both ways, also turn on the option that lets it control this computer, the other way round.

**3. Allow it on the other computer**

The other computer's Dynamic Island shows the request with a number. Check that both computers show the same number, then click **Allow**.

**4. Set how it opens**

A short guide asks whether the computer opens in the Chat Window or in its own window, offers a shortcut that brings it up from any app, and shows what you can do on it. Open the guide again any time from the computer's **⋯** menu → **How to use**.

When the computers can't see each other, use **Pair with a link**: copy the link on the computer you want to control, then paste it on the computer you're at. The link works once and lasts five minutes.

After another computer pairs with yours, a note says what it can use here. Click **Change** to adjust it.

## Choose what a computer can reach

While you allow a pairing, and later on the computer's page in **Settings → Connections**, you choose what the other computer can control here:

| Choice | What the other computer can do here |
| - | - |
| **Chats** | Open chats here and keep them running. |
| **Chats and tools** | Also **Terminal**, **Screen** and **Files**, so its agents can run commands here. |
| **Everything** | Also its agents can start chats here and use this screen. |

Pick **Each switch** to set them one by one:

| Switch | What it allows |
| - | - |
| **Chats** | Open chats here and keep them running. |
| **Terminal** | Open a shell, and let its agents run commands. |
| **Screen** | See this screen and control it. |
| **Files** | Send files to Downloads here. |
| **Agents** | Let its agents start chats here. Off until you turn it on. |
| **Agent control** | Let its agents use this screen and browser. You see when they do and can stop them. Off until you turn it on. |

## Open a computer's chats

The Chat Window sidebar lists one computer at a time. The device switcher at its foot switches between this computer and the paired ones, shows what's waiting for you on the others, and opens any of them in its own window.

* Each computer's list shows its chats and Projects, with what's running and what needs you, and opens them in place.
* Each computer has its own color. Change it from the computer's **⋯** menu → **Color**.
* Chats another computer's agent started carry a mark, and the Chat Window's Search finds that computer's chats too.
* Enconvo notifies you when a reply is ready on another computer, or when its agent needs your answer.

To start a new chat on another computer, use the **Run on** chip in a new chat's message box. What you typed comes along. Press **⌃1** to **⌃9** to switch between computers.

Decks, designs and dashboards on another computer open read-only, and **Read Aloud** isn't offered in another computer's chats.

### In its own window

Choose **Open in its own window** in the computer's **⋯** menu, and its chats open in a window with its own Dock icon in the computer's color. Turn on **Keep in Dock** in the same menu to keep the icon there and open it later.

To make that the default, open **Settings → Connections**, click the computer, and under **Chats** choose **Chat Window** or **Own window**. **Shortcut** sets a key that brings the computer up from any app.

### When a computer is offline

An offline computer's chats stay readable. Click **Continue on This Mac** to start a new chat here with what's on screen, or **Notify me when it's back**.

## Use its screen

The computer's page shows its screen. Watch it, or take control to use it with your own mouse and keyboard.

Click the full screen button, or press **⌃⌥F** (**⌃⌘F** also works on a Mac), to put the picture over the whole display. Move the pointer to the top edge to bring the controls back. Press the same keys to leave, or **Esc** while you only watch. The **Fill the view** button next to it scales the picture to fill the view with no black bars, cropping the edges that don't fit.

While you control the other computer, what it copies reaches your clipboard. A line on the screen says how to stop controlling it.

## Send files

On the computer's page, click **Send files**. They land in **Downloads → Enconvo** on the other computer, never replace a file already there, and resume after a dropped connection.

Files you attach to a chat on another computer go over too, up to 2 GB each, with a progress bar.

## Hand work to another computer

With **Agents** on for a computer, your agent here can start a chat there and read the answer. Mention the computer with `@` in a chat, or ask the agent to use it. Anything the agent wants to do there asks you on that computer first, and the chat says when the other computer is waiting for approval and what for.

With **Agent control** on, the other computer's agents can use this Mac's screen and browser directly, for example to retest a change right away. An overlay here names who is in control and lets you take over or stop it.

While your agent uses another computer, a strip at the top of the chat and a pill above the message box show the latest screenshot from there, with a **Stop** button. The finished run shows as one card with its steps and screenshots.

For running commands on another computer, see [Computers and SSH Hosts](https://docs.enconvo.ai/integrations/computers-and-ssh-hosts.md#let-agents-work-on-a-paired-computer).

## Remove a computer

In **Settings → Connections**, click the computer and choose **Remove**, or choose **Unpair…** in its **⋯** menu in the sidebar. Its chats stay on that computer. To use it again, pair it again.

## Troubleshooting

| Problem | What to do |
| - | - |
| The other computer isn't in the pairing list | Check that it's online, runs Enconvo, and is signed in to the same account. Or use **Pair with a link**. |
| The pairing request didn't show on the other computer | Look for it on the other computer's Dynamic Island. If it quit or lost its connection, start pairing again. |
| A switch on the computer's page is dimmed | The other computer hasn't allowed it. Turn it on for this computer there. |
| The screen or a chat says it can't reach the computer | Check that the computer is awake and Enconvo runs there. Use **Notify me when it's back** to hear when it returns. |

## Related

> [card] [Computers and SSH Hosts](https://docs.enconvo.ai/integrations/computers-and-ssh-hosts.md)
>
> Agents that run commands on your computers and servers.

> [card] [Pair with your phone](https://docs.enconvo.ai/integrations/pair-your-phone.md)
>
> Pair the iPhone or Android app with each computer.

> [card] [Chat Window](https://docs.enconvo.ai/ai/chat.md)
>
> The sidebar and device switcher where paired computers show.

> [card] [Picture in Picture](https://docs.enconvo.ai/features/picture-in-picture.md)
>
> Watch an agent work in a window you can't see.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.