NebulaNebula
Devices

Devices

Devices are the machines your workspace agents use to do real work. Choose a virtual device in the cloud, a local device on your own computer, or both.

A device is the machine your workspace agents actually run on — where they store files, execute code, control a browser, and host live servers. Every workspace can have one or more devices, and a device can be virtual (cloud-hosted) or local (your own machine).

Research Computer / projects / grad-party
research
exports
poster-v3.psd24.1 MB
guest-list.csv18 KB
venues.md6 KB

Two types of device

Virtual deviceLocal device
Where it runsNebula's cloudYour own computer
Always availableYesno — only when your machine is online
Pre-configured environmentYesyou bring your own
Best forAlways-on automations, background jobs, shared team workSensitive files, local apps, custom dev environments
SetupClick + Add Device → VirtualInstall the desktop app, then add it

Devices vs agents

Don't confuse the two:

AgentsDevices
What they doDecide what to doActually do it
What they haveInstructions, tools, memoryFilesystem, terminal, browser, network
Shared withEveryone in the workspaceEveryone in the workspace

Think of it as a team of employees (agents) sharing a workstation (the device). Agents bring the intelligence; the device provides the compute.

Adding a device

Open the Devices section in the sidebar and click +. Pick Virtual for a cloud machine or Local for your own computer.

One device per workspace is marked Primary — that's the default agents reach for. You can switch primaries any time from the device card.

Why have both

Many workspaces run a virtual device for everything by default. Local devices come in when work has to happen on your machine — a private network you VPN into, a folder of files you don't want in the cloud, an IDE or app you've spent years configuring. You can have multiple devices in a workspace and route specific work to a specific one by asking Nebula directly: "Use my local Mac for this."

Notifications when work finishes

When a background task completes, Nebula notifies you in the thread it started in — and optionally pings you on Slack, email, Telegram, or push.

On this page