Command Index

Every command Kaveh has, generated from the running bot (263 commands in 21 categories). Because it comes straight from the code, it is always complete. For advice on when to use a command, see the Command Reference.

• Every command is a slash command: type / in Discord and pick one.
• <option> is required and [option] is optional.
• Use /help in Discord for the same list with live examples.

Admin

Command	What it does
/permissions-audit	List servers where Kaveh holds more permissions than it asks for (bot owner only).
/restart	Restart the bot process (bot owner only).
/say <message> [channel]	Make the bot send a message (bot owner only).
/self-update [allow_dirty]	Check for updates, pull latest commit, and restart (bot owner only).
/shutdown	Shut down the bot.
/status [status] [activity_type] [text] [stream_url]	Set bot presence (bot owner only).
/status-clear [status]	Clear activity text and keep/set status (bot owner only).
/status-show	Show current persisted presence (bot owner only).
/sync [scope]	Sync slash commands.

Badges

Command	What it does
/badge create <key> <name> <emoji> [rule] [value] [rarity] [description]	Create a badge.
/badge delete <badge>	Delete a badge and take it from everyone who has it.
/badge grant <member> <badge>	Give a member a badge.
/badge list	See the badges this server offers and how to earn them.
/badge revoke <member> <badge>	Take a badge from a member.
/badge show [member]	See the badges a member has earned.
/badge starter	Add a ready-made set of badges to this server.

Chat

Command	What it does
/chat ask [message]	Talk to Kaveh and configure chat preferences.
/chat clear	Clear your chat history.
/chat room disable	Disable ambient group chat mode.
/chat room set <channel> [reply_chance] [followup_seconds] [min_interval_seconds]	Set the ambient chat channel and behavior.
/chat room show	Show current ambient group chat settings.
/chat status	Check Ollama backend status.
/chat style reset	Reset style preferences.
/chat style tone <tone>	Set the tone for replies.
/chat style verbosity <verbosity>	Set reply length.

Community

Command	What it does
/booster announce-channel [channel]	Set boost announcement channel.
/booster chat-channel [channel] [lock_to_booster_role]	Set booster chat channel.
/booster dm-message <template>	Set booster DM template.
/booster dm-toggle <enabled>	Enable or disable DM to boosters.
/booster end-message <template>	Set boost end announcement template.
/booster keep-role <enabled>	Keep booster role when boost ends.
/booster message <template>	Set boost start announcement template.
/booster perks <text>	Set human-readable booster perks description.
/booster role [role]	Set booster perk role for active boosters.
/booster status	Show booster configuration and perks.
/booster sync-chat-perms	Apply booster-only permission overwrites to booster chat channel.
/booster sync-role	Synchronize booster role for all members.
/booster test [member]	Send booster announcement test.
/booster toggle <enabled>	Enable or disable booster flow.
/welcome autorole [role]	Set auto-role assigned to new members.
/welcome channel [channel]	Set the welcome channel.
/welcome dm-message <template>	Set the DM welcome template.
/welcome dm-toggle <enabled>	Enable or disable DM welcome messages.
/welcome mention <enabled>	Control whether welcome post mentions the member.
/welcome message <template>	Set the public welcome message template.
/welcome rules-channel [channel]	Set rules channel placeholder target.
/welcome status	Show current welcome configuration.
/welcome test [member]	Send a welcome test message.
/welcome toggle <enabled>	Enable or disable welcome flow.

Economy

Command	What it does
/economy balance [member]	See how many coins you (or someone else) have.
/economy buy <item>	Buy a role from the shop.
/economy daily	Claim your daily coins. The more days in a row, the more you get.
/economy game	Start a word game in this channel now (staff).
/economy pay <member> <amount>	Give some of your coins to another member.
/economy shop	See what you can buy with your coins.
/economy top	The members with the most coins.

Embed Builder

Command	What it does
/embed json [payload] [attachment] [channel]	Post embeds from Discohook JSON payload or .json attachment.
/embed quick <title> <description> [color] [footer] [image_url] [thumbnail_url] [channel]	Post a quick embed to this channel or another channel.
/embed template	Show a Discohook-compatible JSON starter template.

Fun

Command	What it does
/bam <member> <reason>	Bans someone.
/fun bunny	Send a random bunny image.
/fun cat	Send a random cat image.
/fun choose <options>	Choose from comma-separated options.
/fun coinflip	Flip a coin.
/fun dog	Send a random dog image.
/fun eightball <question>	Ask the magic 8-ball.
/fun fox	Send a random fox image.
/fun guess <number> [max_number]	Guess a number.
/fun howgay [member]	Shows how gay a user is.
/fun joke	Get a random clean joke.
/fun poll <question> <options>	Create a quick button poll.
/fun rate <thing>	Rate anything from 0 to 100.
/fun roll [sides]	Roll a dice with custom sides.
/fun rps <choice>	Play rock-paper-scissors.
/fun ship <member1> [member2]	Check compatibility between two members.
/fun tictactoe	Play tic-tac-toe against Kaveh.
/fun trivia	Answer a quick trivia question.
/fun wouldyourather [mode] [member]	Prompt modes: would-you-rather, truth, dare, or compliment.

Help

Command	What it does
/help [query]	Browse Kaveh's commands.

Info

Command	What it does
/info avatar [member]	Show a user's avatar.
/info botinfo	Show bot information.
/info currency <amount> <from_currency> <to_currency>	Convert an amount from one currency to another.
/info dictionary <word>	Look up a word definition.
/info guide [topic]	Tutorial quick-start for setup, moderation, and dashboard.
/info ping	Show bot latency.
/info serverinfo	Show server information.
/info translate <to_language> <text> [from_language]	Translate text to another language.
/info uptime	Show bot uptime.
/info userinfo [member]	Show user information.
/info weather <location>	Show current weather by city/country.
/info wiki <query> [source]	Search Wikipedia (with optional dictionary fallback).

Logging

Command	What it does
/logging channel [channel]	Set the default audit log channel.
/logging events <events>	Set audit log event categories.
/logging include-content <enabled>	Toggle including message content in logs.
/logging route <category> [channel]	Route one log category to a specific channel.
/logging status	Show logging configuration.
/logging test	Send a test audit log entry.

Moderation

Command	What it does
/appeal channel [channel]	Set the appeal review channel.
/appeal review <appeal_id> <status>	Resolve an appeal.
/appeal submit <message>	Submit a moderation appeal.
/automod allowdomain add <domain>	Add an allowed domain.
/automod allowdomain list	List allowed domains.
/automod allowdomain remove <domain>	Remove an allowed domain.
/automod blocklist add <term>	Add a blocked term.
/automod blocklist list	List blocked terms.
/automod blocklist remove <term>	Remove a blocked term.
/automod config <max_mentions> <max_message_rate> <max_caps_ratio> <max_repeat> <block_invites> <block_links> <ignore_staff>	Configure automod thresholds.
/automod status	Show automod settings.
/automod thresholds <timeout_threshold> <timeout_minutes> <kick_threshold> <ban_threshold> <strike_expiry_days>	Configure strike thresholds.
/automod toggle <enabled>	Enable or disable automod.
/mod ban [member] [user_id] [reason] [delete_message_days]	Ban a member.
/mod case edit <case_id> <reason>	Edit the reason for a moderation case.
/mod case remove <case_id>	Remove a moderation case from the case file.
/mod cases [member] [user_id] [limit]	Show moderation cases for a user.
/mod import-cases <file> [apply]	Import legacy moderation cases (ban/kick/warn/mute/unban) from CSV or TXT.
/mod import-warnings <file> [apply]	Import legacy warning history from a CSV or TXT file.
/mod kick <member> [reason]	Kick a member.
/mod log-channel [channel]	Set the modlog channel.
/mod massban <user_ids> [reason]	Ban multiple user IDs.
/mod mute <member> <minutes> [reason]	Timeout a member.
/mod note add <note> [member] [user_id]	Add a moderator note for a user.
/mod note list [member] [user_id] [limit]	List moderator notes for a user.
/mod strike add <member> [points] [reason]	Add strike points to a member.
/mod strike clear <member>	Clear strikes for a member.
/mod strike list <member>	List strikes for a member.
/mod unmute <member> [reason]	Remove a member timeout.
/mod warn <member> [reason] [points]	Warn a member.

Modmail

Command	What it does
/modmail anon <message> [attachment]	Send an anonymous staff reply to the user.
/modmail anonymous <enabled>	Toggle anonymous modmail.
/modmail block add [member] [user_id] [reason]	Stop a member from opening modmail conversations.
/modmail block list	Show members blocked from modmail.
/modmail block remove [member] [user_id]	Let a blocked member use modmail again.
/modmail close [reason] [notify]	Close the current modmail conversation.
/modmail config [channel]	Configure the optional modmail fallback channel.
/modmail guide [channel] [moderation_notes]	Post a modmail + moderation guidance embed in a channel.
/modmail history-hint <enabled>	Toggle whether new modmail messages include past conversation count.
/modmail log-channel [channel]	Set modmail log channel.
/modmail note <message>	Add an internal note.
/modmail open	Open a modmail conversation.
/modmail open-message <template>	Set DM message sent when a modmail conversation opens.
/modmail ping-role [role]	Set a role to ping when new modmail channels are opened.
/modmail priority <priority>	Set modmail priority.
/modmail reminder-channel [channel]	Set modmail reminder channel.
/modmail reopen [thread_id]	Reopen a closed modmail conversation.
/modmail reply <message> [attachment]	Reply to the user from this modmail conversation.
/modmail sla <hours> [auto_close_hours]	Set the reply target and auto-close time.
/modmail snippet add <name> <content>	Create or update a saved reply.
/modmail snippet list	List saved replies.
/modmail snippet remove <name>	Delete a saved reply.
/modmail snippet send <name> [anonymous]	Send a saved reply in this conversation.
/modmail stats [days]	Show how modmail is going for the team.
/modmail status	Show modmail conversation status.
/modmail subscribe	Subscribe to this conversation and get pinged on new user messages.
/modmail subscribers	List subscribers for this modmail conversation.
/modmail tag add <tag>	Add a tag to this modmail conversation.
/modmail tag list	List tags on this modmail conversation.
/modmail tag remove <tag>	Remove a tag from this modmail conversation.
/modmail unsubscribe	Stop subscription pings for this conversation.
/modmail webhooks <enabled>	Toggle webhook relay formatting for modmail.

Music

Command	What it does
/music join	Join your voice channel.
/music leave	Leave the voice channel.
/music loop <mode>	Set loop mode.
/music nowplaying	Show the current track.
/music pause	Pause playback.
/music play <query>	Play a track or playlist.
/music player	Open an interactive music player with live controls.
/music presets	Show built-in radio presets.
/music queue [page]	Show the current queue.
/music radio [preset] [query]	Start or stop radio mode with presets.
/music resume	Resume playback.
/music seek <seconds>	Seek within the current track.
/music shuffle	Shuffle the queue.
/music skip	Skip the current track.
/music stop	Stop playback and clear the queue.
/music volume <volume>	Set playback volume.

Observability

Command	What it does
/observability	Show runtime metrics and active alerts.

Privacy

Command	What it does
/privacy delete	Erase your personal data from Kaveh everywhere.
/privacy export	Get a copy of your personal data as a file.
/privacy info	What Kaveh stores about you and how long it keeps it.

Profile

Command	What it does
/profile badges	See your badges and which ones are pinned to your card.
/profile leaderboard <listed>	Choose whether you are listed on public leaderboards on the website.
/profile pin <badge>	Show one of your badges on your profile card.
/profile theme [palette]	Choose the colour theme of your profile card.
/profile title [title]	Set or clear the short title shown under your name on your card.
/profile title-clear <member>	Remove a member's profile title (for staff, when it isn't appropriate).
/profile unpin <badge>	Take a badge off your profile card.

Progression

Command	What it does
/level admin-reset <member> [keep_reputation]	Reset a member's leveling progress.
/level admin-set <member> [level] [xp_total] [reputation] [messages_sent]	Set a member's level progress values.
/level announce <enabled> [channel]	Configure level-up announcements.
/level announce-channel [channel]	Set or clear the level-up announcement channel.
/level background [image_url] [attachment]	Set or clear your profile card background image.
/level bio [bio]	Set or clear your profile bio.
/level config	Show leveling configuration.
/level cooldown <seconds>	Set leveling XP cooldown in seconds.
/level country [code]	Set or clear your profile country code.
/level country-codes [page]	List all supported country codes.
/level description [text]	Set or clear your profile description.
/level leaderboard [page] [period]	Show XP leaderboard.
/level message-length <characters>	Set minimum message length required for XP.
/level profile [member]	Show leveling profile for a member.
/level pronouns [pronouns]	Set or clear your pronouns.
/level rank [member]	Show your leveling rank.
/level ranks	Show the level rank tiers.
/level rep <member>	Give a reputation point to a member.
/level rep-status	Show when you can give reputation again.
/level reward-add <level> <role>	Grant a role automatically at a target level.
/level reward-list	List all configured level rewards.
/level reward-remove <level> [role]	Remove a configured role reward.
/level timezone [timezone_name]	Set or clear your timezone.
/level toggle <enabled>	Enable or disable leveling.
/level xp <min_xp> <max_xp>	Set XP gain range per awarded message.
/xp backfill	Give reward roles to members who already qualify.
/xp booster-bonus <value>	Give server boosters extra XP.
/xp ignore-channel <channel> [ignored]	Stop (or resume) XP in a channel.
/xp ignore-role <role> [ignored]	Stop (or resume) XP for a role.
/xp ignored	List channels and roles that earn no XP.
/xp multiplier <value> [hours]	Run an XP event, for example double XP.
/xp rank-title <level> [title]	Rename a rank title (or remove a custom one).
/xp rank-title-reset	Go back to the default rank titles.
/xp reward-mode <mode>	Keep every reward role, or only the highest.
/xp voice-xp <amount>	Give XP for time spent in voice channels.

Setup

Command	What it does
/setup automod	Configure automod with quick presets.
/setup chatbot	Alias for chat-room setup (ambient chatbot behavior).
/setup chatroom	Configure ambient chat-room behavior and channel.
/setup color [palette] [custom] [reset]	Choose the accent colour of Kaveh's messages in this server.
/setup language [language]	Set or view the server language (en, pt, es, fr).
/setup leveling	Set up XP levels and level-up announcements.
/setup logging	Guided logging setup with category and route options.
/setup modmail	Guided modmail setup (category and log routing).
/setup roles	Configure moderator and admin roles only.
/setup run	Guided server setup and verification tools.
/setup starboard	Configure starboard quickly (channel + behavior).
/setup status [verify]	Show the current setup state.
/setup suggestions	Set up the member suggestion box.
/setup welcomer	Guided welcome setup for onboarding channels and role assignment.

Starboard

Command	What it does
/starboard bot-messages <enabled>	Allow messages from bots to be posted to starboard.
/starboard channel [channel]	Set the starboard channel.
/starboard emoji <emoji>	Set the starboard emoji.
/starboard enable <enabled>	Enable or disable starboard.
/starboard self-star <enabled>	Allow users to star their own messages.
/starboard status	Show starboard configuration.
/starboard threshold <count>	Set stars needed to post.

Suggestions

Command	What it does
/suggest config anonymous <enabled>	Allow or disallow anonymous submissions.
/suggest config channel [channel]	Set the public suggestion channel.
/suggest config downvotes <enabled>	Allow or disallow downvotes.
/suggest config guardrails <min_account_age_days> <min_member_age_days>	Set account/member age requirements.
/suggest config notify-role [role]	Set optional role mention on new suggestions.
/suggest config reset	Reset suggestion settings to defaults.
/suggest config review-channel [channel]	Set optional staff review channel.
/suggest config show	Show suggestion system settings.
/suggest config toggle <enabled>	Enable or disable suggestions.
/suggest create <content> [anonymous]	Submit a new suggestion.
/suggest delete <suggestion_id>	Delete a suggestion entry.
/suggest list [status] [sort] [page]	List recent suggestions.
/suggest mine [status] [page]	List your own suggestions.
/suggest note <suggestion_id> [note]	Set or clear a staff note.
/suggest stats	Show suggestion queue statistics.
/suggest status <suggestion_id> <status> [note]	Set suggestion status.
/suggest view <suggestion_id>	View one suggestion by ID.

Verification

Command	What it does
/verification post [channel]	Post the verification button in a channel.
/verification raid <action> [minutes]	Pause verification during a raid, or lift the pause.
/verification set [role] [method] [min_account_days] [enabled] [raid_auto] [raid_threshold] [raid_minutes]	Choose the role, the method and the rules for verifying.
/verification status	See how verification is set up and whether it can work.