Skip to main content

​
Synopsis

​
Description

devices manages the devices that are trusted to connect to your profClaw instance. Devices are paired using short pairing codes generated from the web UI or via QR code. Once paired, a device receives a session token and can authenticate with the API.

​
Subcommands

​
devices list

​
boolean
Output as JSON array with id, name, platform, version, and last seen time.

​
devices pair <code>

​
string
required
Pairing code shown in the profClaw web UI or QR code. Codes are short-lived and single-use.
​
boolean
Output the paired device details as JSON.

​
devices unpair <id>

​
string
required
Device ID to remove. After unpairing, the device loses API access.
​
boolean
Skip the confirmation prompt.
​
boolean
Output {"ok": true, "id": "..."} on success.

​
devices info <id>

​
string
required
Device ID to inspect.
​
boolean
Output device details as JSON.

​
Examples

​
Generating Pairing Codes

Pairing codes are generated from:
  • Web UI: Settings > Devices > Add Device
  • QR code: Scan with the profClaw mobile app
Codes expire after a short window. Generate a fresh code if pairing fails.