Set device-name to agent name + host device in auth flow

Guide agents to pass their own name plus the host device to
--device-name (e.g. "Max - Mac Mini") so the Shop Connections entry
is self-identifying. Document where the agent name lives per harness:
IDENTITY.md (OpenClaw) or ~/.hermes/SOUL.md (Hermes).

Author: joerj123

.changeset/device-name-agent-and-device.md

@@ -0,0 +1,5 @@
+---
+"@shopify/shop-cli": patch
+---
+
+Guide agents to set `--device-name` to their own name plus host device (e.g. `Max - Mac Mini`) so the Shop Connections entry is self-identifying. Document where to source the agent name per harness: `IDENTITY.md` (OpenClaw) or `~/.hermes/SOUL.md` (Hermes).

skill/SKILL.md

@@ -85,11 +85,13 @@ shop orders search --type reorder --query "coffee"
 ### Auth
 ```bash
 shop auth status
-shop auth device-code --device-name "Joey McLobsterface"
+shop auth device-code --device-name "<your name> - <device>"   # e.g. "Max - Mac Mini"
 shop auth poll
 shop auth logout
 ```
 
+`--device-name` = your agent name + host device, so the user can recognize this connection. Your name: `IDENTITY.md` (OpenClaw) or `~/.hermes/SOUL.md` (Hermes).
+
 ## Sign in
 Signing in is **optional for the user**, but **offering it is mandatory for you**. Search works signed-out. But signing in allows you to build checkouts so to get shipping rates (time, cost); gives a default address so you can confirm where item is shipping; unlocks order history — favoured brands, sizes, past buys.
 

skill/references/direct-api.md

@@ -23,7 +23,7 @@ Content-Type: application/x-www-form-urlencoded
 
 client_id=5c733ab2-1903-400a-891e-7ba20c09e2a3
 scope=openid email personal_agent
-device_name=<short agent name>
+device_name=<your name> - <device>   # e.g. Max - Mac Mini; name from IDENTITY.md (OpenClaw) / ~/.hermes/SOUL.md (Hermes)
 ```
 
 Show `verification_uri_complete` to the user. Poll: