Chameleon Labs Help - Moderator Commands
Mention @ChatMaster in any channel to start a free AI conversation powered by leading models from OpenAI, Anthropic, and Google.
Access Required: These commands require Manage Roles and/or Manage Channels permissions on your Discord server. The specific permission needed is listed with each command below. Available permissions vary by guild/server configuration.
AI
Export LLM history for a user to CSV (admin/mod only).
Exports a CSV containing LLM prompts and replies for the selected user in the current server, with optional date filters. Bot admins can export across servers and DMs by running the command in a DM with the bot. All exports are audit-logged. Sent as an ephemeral message.
Examples:
Show LLM message history for a user (admin/mod only).
Moderators and admins can view recent LLM prompts and replies for a specific user in the current server, with optional date filters. Bot admins can view across servers and DMs by running the command in a DM with the bot. All reads are audit-logged. Content is truncated for display.
Examples:
Refresh model list from the model registry (admin/mod only).
Syncs the model catalog from the ChameleonLabs model registry, which publishes current model IDs and per-model capabilities (vision, thinking, max output tokens) for each provider (OpenAI, Anthropic, Google). Results are saved to data/llm_models.json. The catalog also auto-syncs when older than 24 hours.
Examples:
Upgrade stored models to track the latest releases (admin/mod only).
Scans personalities and multi-LLM channel configs for pinned model IDs and migrates them to registry family references (e.g. claude-sonnet-4-5 becomes anthropic/sonnet), which always resolve to the latest published model at request time. Runs as a dry-run preview by default; pass apply:True to write the changes. Also reports stale model IDs the registry no longer knows.
Examples:
🤖 Edit an existing AI personality profile (admin/mod only).
Modify any aspect of an existing personality. Use autocomplete to select the personality to edit.
Examples:
Private Area
Directly grant a member access to a private channel (no link needed).
Directly adds a specific member to the channel by granting them view and write permissions. The member will be notified via DM. This does NOT create an invite link - it immediately grants access to the specified user.
Use this when: You want to add a specific member to your private channel
Requirements: You must be the channel owner (created via /mychannel) or a moderator/admin.
Examples:
Remove a member's access from your private channel.
Removes a member's explicit permission override from the channel, revoking their access. The member will be notified via DM. This only removes direct permission overwrites - if they have access through a role, you'll need to manage that separately.
Use this when: You want to revoke a specific member's access to your private channel
Requirements: You must be the channel owner (created via /mychannel) or a moderator/admin.
Examples:
BBS
BBS administration commands (admin/mod only).
Administrative commands for BBS contest management. Requires moderator or admin permissions.
Subcommands:
/bbs_admin contest_create <title> <desc> [end] [prizes] [goal]- Create a contest/bbs_admin contest_create_goal <title> <desc> <goal> <target>- Create goal-based contest/bbs_admin contest_edit <contest> [fields...]- Edit a contest (by title or ID)/bbs_admin contest_end <contest>- End a contest and announce winners/bbs_admin recurring_create <title> <desc> <frequency>- Create an auto-recurring contest/bbs_admin recurring_list- List active recurring contests/bbs_admin recurring_delete <id>- Delete a recurring contest
Contest Goal Types:
- Traditional - Most commands wins (default)
- First to ALL 🎯 - First to use all user-level commands (auto-wins!)
- First to Group 🎯 - First to complete all commands in a category
- First to Count 🎯 - First to reach N total commands
Available Command Groups: bbs, social, games, private, channel, llm, personality, memory, privacy, repo, utility, news, keys
Creating Goal-Based Contests:
- Use
/bbs_admin contest_createwithgoal:to select type - For group/count goals, use
/bbs_admin contest_create_goalwithtarget: - Goal quests auto-complete when someone achieves the goal!
Contest Scoring:
- Only user-level commands count (mod/admin commands excluded)
- Admins and moderators are excluded from rankings
- Goal quests announce winner automatically when achieved
Tips:
- Use contest title or ID (with autocomplete) for editing
- Leave prizes empty for 'Bragging rights'
- Use 'clear' to remove end_date or prizes
Examples:
[Mod] Create a contest.
Create a new BBS contest with optional goal type.
Examples:
[Mod] Create a goal-based contest.
Create a contest with a specific goal: first to complete all commands in a group, or first to reach N total commands. Target is the group name (for group goals) or the count (for count goals).
Examples:
[Mod] Edit a contest.
Modify an existing contest's settings.
Examples:
[Mod] End a contest and announce winners.
Close a contest and publish the results.
Examples:
[Mod] Create an auto-recurring contest.
Create a contest that re-creates itself automatically on a weekly or monthly schedule. Title/description templates may use {week}, {month}, and {year} placeholders.
Examples:
[Mod] Delete a recurring contest.
Remove a recurring contest schedule. Use /bbs_admin recurring_list to find the ID.
Examples:
[Mod] List active recurring contests.
Show all recurring contest schedules configured for this server.
Examples:
Add an image to a poll option (for image voting).
Attach an image to a poll option. Only works on draft polls. Images are stored temporarily until the poll is published.
Examples:
Close a poll and optionally announce results.
Closes a published poll, preventing further votes. Can optionally announce final results.
Examples:
Create a new poll (draft mode by default).
Create a poll with multiple options. Polls start in draft mode so you can add images before publishing. Use /poll publish to make it live.
Examples:
Permanently delete a poll.
Delete a poll and all its votes. Cannot be undone.
Examples:
Edit poll title, description, or end date.
Modify poll settings. Works on draft and published polls.
Examples:
List all polls in the server.
View all polls with their status, type, and end dates.
Examples:
Publish a draft poll to open voting.
Publishes a draft poll, posting the announcement message and opening it for voting.
Examples:
Remove an image from a poll option.
Remove a previously added image from a draft poll option.
Examples:
View poll results (respects visibility settings).
View current poll results. Visibility depends on poll settings: always, after voting, or after close.
Examples:
Broadcast a message to all users (admin/mod only).
Classic Unix 'wall' command. Posts a system-wide message in the channel visible to all members. Requires moderator permissions.
Examples:
Keys
Check if you have the required key to access a channel.
Checks whether you have the necessary key to join a protected channel.
Examples:
Remove key requirement from a channel (admin/mod only).
Removes the key requirement from a protected channel, allowing normal access rules.
Examples:
Set or show a key requirement for a channel (admin/mod only).
Protects a channel by requiring users to have a specific key to join it. Omit the key parameter to see the current requirement.
Examples:
Grant a capability key to a member.
Grants a permanent key (capability) such as 'invite_all'. By default, keys have unlimited uses and never expire. You can optionally limit uses or set a time-to-live. Special keys: 'noai' denies access to all LLM chatbot features. Requires Manage Roles. Guild-only; moderator/admin only.
Examples:
Revoke a key from a member.
Removes a previously granted key (including special keys like 'noai'). Requires Manage Roles. Guild-only; moderator/admin only.
Examples:
Assets
Upload a named ANSI/SVG asset (admin/mod only)
Stores the attached file under the given name with automatic versioning. Requires moderator permissions or an ANSI key.
Examples:
Reports
List user reports
View user reports submitted by server members. Filter by status or reported user.
Examples:
Resolve a user report
Update the status of a user report. Mark as reviewed, dismissed, or actioned.
Examples:
View a user report's details
View the full details of a specific user report by ID.
Examples:
Manage report notification DM alerts (admin/mod).
View or change your report alert subscription preferences. Project reports (from /report project): Admins get DM alerts by default, mods do not. User reports (from /report user): Both admins and mods get DM alerts by default. You can subscribe, unsubscribe, or reset to default behavior.
Examples:
Export GitHub issues to a Markdown document (admin/mod only).
Generates a Markdown listing of GitHub issues with metadata; use filters to scope the export.
Examples:
Moderation
Set the anti-spam alert channel
Sets the channel where ban proposals are posted when a spam burst is detected.
Examples:
Enable or disable anti-spam for this server
Turns the automatic spam-burst detection on or off for this guild.
Examples:
Show anti-spam status for this server
Displays whether anti-spam is enabled, the alert channel, the trigger thresholds, and warns about any missing bot permissions.
Examples:
Administration
Exclude a channel from bot responses.
Prevents the bot from responding to any messages in the specified channel. Useful for channels where you don't want AI chatbot interactions. Requires administrator or moderator permissions.
Examples:
Re-enable bot responses in an excluded channel.
Removes a channel from the exclusion list, allowing the bot to respond again. Requires administrator or moderator permissions.
Examples:
Emulate a lower-permission user context for this server.
Temporarily emulate lower-access permissions to see what regular users or moderators can see.
Modes:
- on / user - Emulate regular user (no special permissions)
- moderator - Emulate moderator permissions
- off - Restore real permissions
- status - Show current emulation state
Advanced:
/emulate user @username- Emulate specific user (admins only)
ADMIN_OVERRIDE:
Include the text 'ADMIN_OVERRIDE' (case-sensitive) in any message to see admin/mod commands in bot responses, even while emulating. Command execution still uses emulated permissions.
Examples:
/emulate on- Start emulating regular user/emulate status- Check current mode/emulate off- Restore admin permissions@bot show me admin commands ADMIN_OVERRIDE- See admin commands while emulating
Note: The /emulate command itself is always available (your escape hatch).
Examples:
Show the current default private category.
Displays which category new private channels will use by default.
Examples:
Make a role self-assignable (admin).
Adds a role to the list users can self-assign. Cannot add roles with admin permissions. The bot's role must be higher than the target role.
Examples:
Remove a role from self-assignable list (admin).
Removes a role from the self-assignable list. Users who already have the role will keep it.
Examples:
Repository
[Mod] Index a GitHub repository for code search.
Add a GitHub repository to the searchable codebase.