Guides 53 pages
On this page

Guides

Connect a workspace machine

Add a dedicated machine that runs agents for the whole workspace, even when members are offline, with a one-time setup code.

A workspace machine runs agents for the whole workspace and keeps working when members are offline. It belongs to the workspace, not to one person. Use it for scheduled agents that should run overnight, or for a dedicated computer such as a Mac mini.

Who can do this: only workspace owners and admins can connect or manage workspace machines. Workspace machines are a Pro add-on; see Billing and plans.

A machine becomes a workspace machine only by joining with a setup code. A computer you already use with Cyborg can become one too: on the desktop join screen, a personal computer offers “Use this computer as a workspace machine”, which moves your personal data into a folder on the computer and gives it a new identity. From the command line you can instead add a workspace machine beside the personal one (below).

Start from the app

  1. Open Settings → Machines and find the Workspace machines section.
  2. Click Connect workspace machine and set up a dedicated machine, such as a Mac mini, to run workspace agents around the clock.

A dedicated machine

  1. Enter a Name, for example “Office Mac mini”, and click Get setup code.

  2. On the new machine, install Cyborg, choose Set up as a workspace machine on the sign-in screen, and enter the setup code. The dialog also links the Mac and Windows downloads.

  3. No display or keyboard? Open No display or keyboard? Run this command in Terminal instead in the dialog and run the command it shows. It is the CLI form:

    CYBORG_SETUP_CODE=CYB-XXXX-XXXX cyborg daemon join

    --code CYB-XXXX-XXXX works too, but the environment keeps the code out of the process list. It needs no account and no cyborg daemon claim. To install the CLI first, see Add a machine.

  4. The dialog waits, then confirms that the machine is connected to the workspace.

From the command line, in one step

A workspace admin signed in on the new machine (cyborg login) can create the code and join with it at once, into a daemon home and port of its own, so a personal daemon on the same computer keeps running untouched:

cyborg daemon add-worker --workspace <workspace-id> --role operator --service

See Join with a setup code in the CLI reference.

A setup code is single use and expires (the dialog shows the time left and says codes are valid for 24 hours). The code is shown once. If you lose it, choose Get new code on the Machines page; the previous code stops working. Cancel setup cancels a code that has not been used.

After it is connected

  • Workspace access decides who can use the machine: All members · Can run agents, All members · Can message agents, or Restricted (only the people you add under Access on the machine’s page).
  • Members can pick the machine when they start an agent; it appears under Workspace machines in the machine picker.
  • Moving an existing agent to this machine keeps its owner, who needs Can run agents access here. See Move an agent to another machine.
  • To take a machine out, open it and choose Remove from workspace. Members lose access immediately (except people granted access individually), and agents already running on it continue to run. A machine that was connected from someone’s own computer remains that person’s personal machine.
  • The machine itself shows a home screen saying it is managed by your workspace. Keep it plugged in and awake, and do not quit Cyborg on it.