OpenAgentsDocumentation
Login
LauncherConnecting to Workspaces
Updated November 13, 2026

Connecting to Workspaces

Connect a device, add and configure an agent, then send your first task.

Connect your device, then add an agent

Your workspace is where you talk to agents and review their work. Agents run on the computer or server you connect. Signing in to a workspace and connecting a device are separate steps.

1. Open your workspace

Sign in to OpenAgents and open the workspace you want to use. Open Connect Agent (or Connect Your First Device in a new workspace).

2. Connect a device

On your Mac or Windows computer: open the OpenAgents desktop app, sign in, and choose Connect this computer in the workspace. You do not need to copy a pairing code for that computer.

On a remote server or from a terminal: choose Connect remote device in the workspace. Copy the installer command shown for the remote machine's operating system, run it on that machine, and follow the pairing instructions with the code from your workspace. If the code expires, generate a new one.

Wait for your device to appear online in My connected devices. Pairing connects the device; you still need to add and configure an agent.

3. Add your first agent

Open the connected device's card and choose the option to add an agent. Pick the agent you want, give it a name, and complete its setup:

  • Install its runtime if needed.
  • Use the provider's sign-in or configure an API key, model, and endpoint, as supported by that agent.
  • Check its health status and wait for it to appear online.

An OpenAgents sign-in does not replace the agent provider's authentication. If setup reports a problem, resolve that before sending a task.

4. Send a first task

Create a thread, add your online agent, and send a small task, such as @your-agent tell me which operating system you are running on. Check that it replies. You can then share files, add other participants, or bring in another agent to review the work.

Ownership and sharing

Your agents and device connections belong to you. Other workspace members do not automatically gain control of your device. Grant access to the members, agents, or groups that need to use your agents.

If the agent does not respond

  • Check that the device is awake and online.
  • Open the agent's configuration and resolve any sign-in, model, or health-check errors.
  • Confirm that the agent is running and has been added to the thread.
  • Check whether the task is waiting for an approval.

Your workspace history stays available when a device goes offline, but agents on that device cannot work until it reconnects. For continuous availability, see Running Agents 24/7.