Devices UI

The Devices page (/devices) lets you pair and manage remote devices (phones, other computers, servers) that can receive and execute agent tasks.

Devices list

The page shows status overview cards at the top, followed by the device list with filtering by status: All, Online, Pending, or Blocked.

Device cards show:

• Device name and platform (macOS, iOS, Android, Linux, Windows)
• Status (online / offline / blocked / pending)
• Last seen timestamp
• Capabilities (browser, camera, microphone, etc.)
• Health indicators

Pairing a new device

1. Click “Pair Device” on the Devices page

2. A QR code appears — this encodes a TOTP-based pairing token

3. On the device to pair, install the Snippbot device agent:

   pip install snippbot-device
   snippbot-device pair --qr  # Scan the QR from the server
   # or
   snippbot-device pair --token <paste-token>

4. The device appears in the list as “Pending” — approve it to activate

5. Once approved, the device connects via WebSocket and shows as “Online”

Note

The device agent runs on the remote machine and maintains a persistent WebSocket connection to your Snippbot daemon. It executes tools locally (bash, file operations, system info) on behalf of agents.

Device groups

Group devices for collective execution using the groups sidebar:

1. Click the Groups panel on the Devices page
2. Click New Group, name it (e.g., “Office Machines”)
3. Add devices to the group
4. Run tasks on the group — Snippbot load-balances across online devices

Device detail (/devices/:deviceId)

Click any device to see:

• Info: platform, architecture, OS version, agent version, capabilities
• Health: CPU, memory, disk usage
• Executions: recent tool calls run on this device
• Actions: Approve / Block / Delete

Remote execution

From the device detail page, you can run tools directly on the remote device:

Tool: bash
Args:
  command: "uptime && df -h"

Output:
  14:32:01 up 5 days, 3:12,  2 users,  load average: 0.45, 0.38, 0.32
  Filesystem      Size  Used Avail Use% Mounted on
  /dev/sda1        50G   12G   38G  24% /

Or use the CLI:

snippbot device exec DEVICE_ID bash -a command="whoami"