Skip to content
ArchmageDocs

archmage device

The device subcommand manages the devices bound to your license. It has two subcommands: list shows the bound devices, and remove unbinds one of them.

Switching to a New Machine

Section titled “Switching to a New Machine”

Each license can be bound to a limited number of devices. When all of them are in use, archmage auth on a new machine reports that the license has reached its device limit.

You can run list and remove on any machine. On a machine that is not activated, they ask for your license key each time.

  1. List the devices bound to your license:

    Terminal window
    archmage device list

    See archmage device list for a sample of the output and what each column means.

    Find the device you no longer use, and copy its ID from the Device ID column.

  2. Remove that device:

    Terminal window
    archmage device remove 8a1d9e4f-2b3c-4d5e-8f6a-7b8c9d0e1f2a

  3. Activate the new machine:

    Terminal window
    archmage auth

Usage

Section titled “Usage”
Terminal window
archmage device list
archmage device remove <device-id>

archmage device list

Section titled “archmage device list”

list shows every device bound to your license, one row per device.

+--------------------------------------+---------+------------+---------------------+---------------+
|              Device ID               |   OS    |  Hostname  |      Bound At       |               |
+--------------------------------------+---------+------------+---------------------+---------------+
| 3f2b8c1e-7a4d-4e9b-9c1a-5d6e7f8a9b0c | darwin  | studio-mac | 2026-08-02 10:15:42 | ← this device |
| 8a1d9e4f-2b3c-4d5e-8f6a-7b8c9d0e1f2a | windows | build-pc   | 2026-07-18 16:40:09 |               |
+--------------------------------------+---------+------------+---------------------+---------------+
* 2 device(s) bound to this license.
Column Content
Device ID The ID that remove takes
OS The operating system of the device
Hostname The hostname of the device
Bound At When the device was bound to the license

If the machine you run list on is activated, it is marked with ← this device.

archmage device remove

Section titled “archmage device remove”

remove unbinds the device with the given ID from your license.

If you remove the current machine, its activation is cleared as well.

A license allows at most 3 removals in any 24-hour period.