docs: update CLI reference

Signed-off-by: Tomas Weiss <[email protected]>

Author: tomkis

docs/development/reference/cli-reference.mdx

@@ -332,6 +332,57 @@ List all configured servers:
 agentstack server list
 ```
 
+## User Commands
+
+### user list
+
+List platform users (admin only):
+
+```bash
+agentstack user list [OPTIONS]
+```
+
+**Options:**
+- `--email <email>`: Filter by email (case-insensitive partial match)
+- `--limit <number>`: Results per page (1-100, default: 40)
+- `--after <cursor>`: Pagination cursor (page_token)
+
+**Examples:**
+```bash
+# List all users
+agentstack user list
+
+# Filter by email
+agentstack user list --email [email protected]
+
+# Paginate through results
+agentstack user list --limit 20 --after <cursor-token>
+```
+
+### user set-role
+
+Change user role (admin only):
+
+```bash
+agentstack user set-role <user-id> --role <role>
+```
+
+**Arguments:**
+- `user-id`: User UUID
+
+**Options:**
+- `-r, --role <role>`: Target role (admin, developer, user)
+- `-y, --yes`: Skip confirmation prompts
+
+**Examples:**
+```bash
+# Promote user to admin
+agentstack user set-role abc123 --role admin
+
+# Demote user to developer without confirmation
+agentstack user set-role abc123 --role developer --yes
+```
+
 ## Environment Commands
 
 ### env