Status and avatars
The status message
Section titled “The status message”The bot keeps a #dashboard channel at the top of your server, outside any category.
It holds one message from the bot, and the message updates itself.
The bot finds the message again after a restart and makes a new one if you delete it. It pins the message when the bot has the Pin Messages permission; without it the message still works, and the bot logs a warning once.
What it shows
Section titled “What it shows”Under the title there is an “Updated” time, in your configured time zone, and any lines that plugins add.
The words on the message follow locale.
The examples below use English; locale: "zh-TW" makes the bot write them in Chinese.
Each active agent has a block with:
- Its display name and a link to its channel.
- Its model and thinking level.
- Its state:
Idle,Workingwith the channel it works in, or a count of queued messages. A queue is shown next to Working, as in “2 queued”. - How much of its context window is used, such as
context 12k / 200k (6%). Right after the context is compacted it says so, and the figure returns at the next turn. - How many schedules it has, and when it was last active, or “No activity since startup”.
Each active group has its display name, a link to its channel, its members and host, whether it is idle or has replies in progress, and its last activity.
When a list is too long for one Discord message, the block ends with a count of the entries that were left out. Archived agents and groups are not listed.
When it refreshes
Section titled “When it refreshes”The message updates when something changes, such as a turn starting or ending or an agent being created. Discord limits message edits, so the bot edits it at most once every 10 seconds. It also refreshes every 5 minutes, so the last-activity times and the context figures stay current.
Avatars
Section titled “Avatars”Each agent speaks in Discord under its own name and picture. Each picture is the agent’s character, composed from parts and drawn by the bot itself: no image provider is involved.
- A new agent gets the look its role suggests: a class (wizard, knight, scholar, ranger and 20 more) in one of eight colors.
agent_createaccepts aclassand acolorto choose them. - The
agent_avatartool changes the look later: a class, a color, or single parts such as the hat, prop, hair, build, or skin. What it leaves out stays as it is, and a new class keeps the agent’s colors. - The owner’s profile panel (
/profile) has a class dropdown and a color dropdown that do the same. - The new picture shows from the agent’s next message.
- Every agent present before 0.23 gets a character at its first start, so its Discord picture changes once.
The bot needs canvas with SVG support (librsvg) to draw the pictures, and refuses to start the agent server without it.
bunx roundtable doctor runs the characters check for this.
Where the pictures are served
Section titled “Where the pictures are served”The bot stores avatars in the data directory and serves them at PUBLIC_URL, under /avatars/.
Discord fetches them from there, so the address has to reach the process from the internet.