remoteagent.online  the open-source control plane for secure, cost-controlled AI agents
Rremoteagent.online

Onboard a new device to your AI agent

Add a new machine to your agent fleet safely: install, log in, assign the device, set capabilities, and verify. Step by step for macOS and Linux.

Updated 2026-08-22Reading time 6 min

Before you start

Onboarding is a security event, not just an install: the new machine will hold a device token that can act on your behalf. Treat it like adding a new work laptop to your accounts.

Step 1 — install and log in

  1. Install the agent on the new machine: macOS or Linux guide.
  2. Log in: remoteagent login and complete the link in the browser.
  3. Confirm the device appears under Devices in the console.

Step 2 — assign and scope it

  1. Open the device assignment view and attach the device to the right agent profile.
  2. Set the device’s capabilities: which tools it may use, which folders it may touch.
  3. Start restrictive — you can widen later, and the audit log will show exactly what changed.

Step 3 — verify the basics

  • Run a harmless task: remoteagent chat "list the files in my home folder".
  • Check the run appears in live logs and the Deep Dive trace.
  • Test one denied action to confirm policy works — a blocked command is a pass.

Fleet view

With several devices, the multi-device fleet guide covers claiming, offline devices and how tasks are routed. If the new machine will run unattended, combine this with headless operation.