Remote machines

Work with agents on another computer or a Neoo Connect machine from Neoo Desktop, and add projects on that machine.

From Neoo Desktop, you can chat with agents on your other machines: another computer running Neoo Desktop, or a server running Neoo Connect. The files stay on that machine; you drive the conversation from here.

Before you start

For your personal machines, the other machine must be:

  • Signed in with the same Neoo account as this computer.
  • Online: Neoo Desktop open on it, or Neoo Connect installed and signed in. See Install Neoo Connect.

Open Remote conversations

Choose one of:

  • On the home screen, click Remote conversations.
  • In the conversation sidebar, open the machine menu (Choose a computer) and pick the machine.

The machine menu lists This computer and your other machines, each marked Online or Offline. If it shows No other computer is connected to this account., open Neoo or start Connect on the other machine.

Neoo remembers the machine you were working on. When you come back from Bots, Teams or the settings, that machine is selected again — as long as it is still online. If it went offline, Neoo falls back to the first reachable machine.

See the account usage of a remote conversation

The Environment panel of a remote conversation shows Usage, the remaining quota of the Claude or Codex account running it, as it does for a local conversation. With an Automatic account, Neoo asks the remote machine which account it picked.

Update Neoo on both machines to see this with several accounts. If the remote machine runs an older version or Neoo Connect, Usage only appears when it has one signed-in account.

Find archived conversations

While you are in Remote conversations, open the command palette with ⌘K on macOS or Ctrl+K on Windows and choose List archives. The list shows Archived on machine first, then Archived on this computer below, and your search filters both.

  • An archive from the remote machine opens in Remote conversations.
  • An archive from this computer opens as a local conversation and leaves the Remote view.

Start a conversation on the remote machine

  1. Select the machine.
  2. Click New Agent. Neoo lists the projects of that machine, most recent first.
  3. Pick a project and write your request, like in any conversation.

Add a project on the remote machine

To work on a folder the remote machine hasn't opened yet:

  1. Click the folder button at the top of the sidebar (Add a project on this machine), or choose New project in the project list.
  2. Neoo opens Open a project on machine, a folder browser of the remote machine:
    • Favorites gives quick access to the home folder and common folders such as Documents or Desktop.
    • Use Back, Forward and the path bar to move around, and Search to filter.
    • Git repositories are marked Git repository in the Kind column.
  3. Select a folder and click Open.

The project opens in the background on the remote machine, and Neoo creates a conversation in it.

What the browser can and can't show:

  • Only folders inside the machine's home folder. The home folder itself can't become a project: Neoo asks you to Pick a folder inside your home folder.
  • Only folders. File names and hidden folders are never shared.
  • At most the first 500 folders of a location.

The browsing is end-to-end encrypted and only answers desktops signed in to your own account, never a teammate's.

Which account runs the agent on a Connect machine

On a personal workspace hosted by Neoo Connect (outside Forge), new conversations use a Claude or Codex account from your Neoo Desktop. The agent runs on your account while the files stay on the remote machine.

Choose an explicit account for these conversations. Neoo can't use Current CLI login with a Connect machine. If no account is available, add one in Settings → Providers.

Forge projects in Remote

Forge projects are listed for authorized project members whose Neoo account is linked to Forge. They share the project's conversations and permissions; viewer access remains read-only.

Every Forge project offers Neoo · Auto, selected by default in new conversations. No administrator setting is needed.

  • Neoo · Auto uses platform accounts, selects the model automatically, and uses the project's Forge credits.
  • Personal models use the sending member's own account connected at Forge connections. Choose Claude, Codex or Gemini and a model in the picker. These requests do not consume Forge AI credits.

You can return to Neoo · Auto from the Neoo tab at any time. The choice applies to the conversation's next requests; changing it does not change the account or billing of an already queued request. Each project and conversation keeps its own selection.

The Forge accounts button beside the model picker explains the connection steps. Accounts added to Neoo Desktop are not automatically connected to Forge, and a Forge connection does not add that account to your local Desktop account list. Forge runs these conversations in the project's workspace. A missing personal connection does not fall back to a platform account.

Long Forge conversations open on their most recent messages; select Load earlier messages to read further back.

Each Forge conversation has its own queue. Messages sent in different conversations of the same project run at the same time (up to eight turns per project). A message sent while its own conversation is busy waits for that turn and shows Queued: starts after the current request. Imports, restores and Design work still run alone in the project. With matching Forge, Connect and Desktop updates, Steer stops the current turn in that conversation and resumes with the selected queued message first, preserving its files. It does not interrupt other conversations. The Cancel this queued message button (×) removes it from Forge.

If a personal connection expires, every request that fails shows Forge's error message in the conversation, and the conversation returns to idle instead of staying in progress. Forge then shows Reconnection required for that provider on Forge connections. Reconnect the account there, or switch the conversation to Neoo · Auto.

The browser button of a Forge conversation opens the Forge preview: the app running in the project's workspace, as in the Forge studio's preview tab. A sleeping workspace shows its standby page or last build. The toolbar reloads the preview or opens it in your default browser. If the workspace has no preview yet, the panel shows Forge's message and a Retry button. The agent's own browser inside the workspace is not shown.

SSH connections

The SSH connection entry on the home screen isn't available yet. To work on a server today, install Neoo Connect on it and use it as a remote machine.