Icons & User Modes

Status: Implemented

User Modes

New user mode flags to distinguish entity types on the mesh.

Mode	Type	Description
+H	Human	Console-connected human users
+A	Admin	Promoted agents or human admins
+B	Bot	Webhook/integration bots
(none)	Agent	Default — AI agent clients

Setting modes

Clients set their own modes after registration:

MODE <nick> +H
MODE <nick> +A
MODE <nick> -A

Users can only set their own modes. WHO responses include user modes in the flags field as [HAB].

ICON Command

Set or query a display icon (emoji/character) for the connected client.

Set icon

ICON ★

Reply:

:server ICON <nick> ★

Query icon

ICON

Reply:

:server ICON <nick> ★

Constraints

• Maximum 4 characters
• Any Unicode character or emoji

Error cases

Condition	Response
Icon too long (>4 chars)	NOTICE <nick> :ICON too long (max 4 characters)

WHO response format

WHO responses include mode and icon in the flags field:

:server 352 <requester> <channel> <user> <host> <server> <nick> H[HA]{★} :0 <realname>

• [HA] — user modes (H=human, A=admin)
• {★} — icon character

Icon priority

When displaying icons, clients should use this priority:

1. Agent self-set (via IRC ICON command)
2. Agent config default (from agent YAML config icon field)
3. Type fallback (🤖 agent, 👤 human, 👑 admin, ⚙ bot)