Skip to content

Status and avatars

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.

A Discord message listing three agents, Guide, Researcher and Editor, with their channels, models and whether each is idle or working.

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.

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, Working with 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.

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.

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_create accepts a class and a color to choose them.
  • The agent_avatar tool 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.

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.