Skip to main content
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.

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: Pick Each switch to set them one by one:

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.

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

Computers and SSH Hosts

Agents that run commands on your computers and servers.

Pair with your phone

Pair the iPhone or Android app with each computer.

Chat Window

The sidebar and device switcher where paired computers show.

Picture in Picture

Watch an agent work in a window you can’t see.