> ## Documentation Index
> Fetch the complete documentation index at: https://docs.profclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# profclaw devices

> Manage paired devices - list, pair with a code, unpair, and inspect device details.

## Synopsis

```bash theme={null}
profclaw devices <subcommand> [flags]
```

## 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

| Subcommand | Alias | Description |
| - | - | - |
| `list` | `ls` | List all paired devices |
| `pair <code>` | - | Pair a new device using a pairing code |
| `unpair <id>` | - | Remove a paired device |
| `info <id>` | - | Show details for a specific device |

## `devices list`

**--json** `boolean`

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

## `devices pair <code>`

**code** `string` *required*

Pairing code shown in the profClaw web UI or QR code. Codes are short-lived and single-use.

**--json** `boolean`

Output the paired device details as JSON.

## `devices unpair <id>`

**id** `string` *required*

Device ID to remove. After unpairing, the device loses API access.

**--yes** `boolean`

Skip the confirmation prompt.

**--json** `boolean`

Output `{"ok": true, "id": "..."}` on success.

## `devices info <id>`

**id** `string` *required*

Device ID to inspect.

**--json** `boolean`

Output device details as JSON.

## Examples

```bash List paired devices theme={null}
profclaw devices list
```

```bash Pair a new device theme={null}
profclaw devices pair ABC-123
```

```bash Show device details theme={null}
profclaw devices info d3a4f5e6
```

```bash Unpair a device theme={null}
profclaw devices unpair d3a4f5e6
```

```bash Unpair without confirmation theme={null}
profclaw devices unpair d3a4f5e6 --yes
```

```bash List devices as JSON theme={null}
profclaw devices list --json | jq '.[].name'
```

## 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.

## Related

* [`profclaw auth`](https://docs.profclaw.ai/cli/auth) - User and invite management
* [`profclaw security`](https://docs.profclaw.ai/cli/security) - Security policies
* [Security Guide](https://docs.profclaw.ai/security) - Authentication and device trust model


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.