Skip to main content
Freesona commands work as both prefix commands (default prefix ~) and slash commands (/). The prefix is configurable per server with ~prefix <symbol> and persists across restarts. A few commands like /setpersona and /autonomy are slash-only because they rely on Discord’s modal and button UI interactions.

AI Commands

CommandActionPermission
~write <prompt> (/write, alias ~w)Structured output using the active personaAnyone
~ask <question> (/ask, alias ~a)Conversational response using the active personaAnyone
~search <query> (/search, alias ~s)Web search with AI summaryAnyone
~separate <url> (/separate, aliases ~sep, ~stems)Vocal/instrumental separation via MVSEPAnyone
/kbsearch <query>Search the local ChromaDB knowledge baseAnyone
/kbadd <title> [content] [attachment]Add text or a PDF/EPUB attachment to the knowledge baseAdministrator
/kblistList the newest knowledge base entriesAdministrator
/kbdelete <id>Delete a knowledge base entry by IDAdministrator

RSS / News

CommandActionPermission
/rss latest <feed>Show latest items from an RSS/Atom feedAnyone
/rss listList configured feeds and the auto-post channelAnyone
/rss add <name> <url>Add or update an RSS feedAdministrator
/rss remove <name>Remove an RSS feedAdministrator
/rss setchannel <#channel>Set the RSS auto-post channelAdministrator
/rss clearchannelDisable RSS auto-postingAdministrator

Conversation Channel

CommandActionPermission
/setchannel #channelSet the AI conversation channelAdministrator
/clearchannelRemove the conversation channelAdministrator
/clearmemoryClear server-side conversation history for the channelAdministrator
/chatmode <all/mentions/smart>Set when the bot replies in the conversation channelAdministrator
The bot responds to messages in the configured conversation channel based on the chat mode:
  • all — replies to every message.
  • mentions — replies only to direct mentions and replies to the bot.
  • smart — also responds to messages that include attachments.

Persona & Memory

CommandActionPermission
/setpersonaOpen the button-based persona editor (slash-only)Bot Owner
/personalock (~personalock, alias ~plock)Lock persona against changesBot Owner
/personaunlock (~personaunlock, alias ~pulock)Unlock persona for editingBot Owner
/personasave <name> (~personasave, alias ~psave)Save the current persona as a named presetBot Owner
/personaload <name> (~personaload, alias ~pload)Load a saved persona presetBot Owner
/personalist (~personalist, alias ~plist)List all saved persona presetsBot Owner
/personadelete <name> (~personadelete, alias ~pdel)Delete a saved persona presetBot Owner
/debugpersona (~debugpersona, alias ~pdeb)Show active persona, provider, model, and lock stateBot Owner
/memorylist [user] (~memorylist, alias ~meml)List long-term memory facts for a userUser (own) / Administrator
/memoryclear [user] (~memoryclear, alias ~memcl)Clear all long-term memory facts for a userUser (own) / Administrator
/memorydelete <index> [user] (~memorydelete, alias ~memdel)Delete a specific memory fact by list numberUser (own) / Administrator
/migrate (~migrate)Migrate legacy JSON memory to SQLiteAdministrator

Runtime Controls

CommandActionPermission
/module listList enabled/disabled modules with load stateAdministrator
/module enable <name>Enable and load a moduleAdministrator
/module disable <name>Disable and unload a moduleAdministrator
/module reload <name>Reload an enabled moduleAdministrator
/model showShow the active AI modelBot Owner
/model set <name>Set the active AI modelBot Owner
/model resetReset to the environment/default modelBot Owner
/provider showShow the active AI providerBot Owner
/provider set <name>Set the active provider (gemini, openai, ollama, nim, azure, groq, openrouter)Bot Owner
/provider resetReset provider to the environment/defaultBot Owner
/botwhitelist (~botwhitelist, alias ~bw)List whitelisted bot IDsAdministrator
/botwhitelist add <bot_id>Add a bot ID (integer snowflake) to the whitelistAdministrator
/botwhitelist remove <bot_id>Remove a bot ID from the whitelistAdministrator
/syncSync global slash commandsBot Owner
/dumpconfigDump current config.json contentsBot Owner
/config show [key]Show all runtime config values, or one specific keyBot Owner
/config listList all configurable keys with descriptionsBot Owner
/config set <key> <value>Set a runtime config valueBot Owner
/config reset <key>Reset a config key to its default valueBot Owner
/settimezone <timezone>Set the bot’s timezone (IANA format, e.g. Asia/Manila)Administrator
/timezoneShow the bot’s currently configured timezoneAnyone
Module and model names support slash-command autocomplete suggestions.

Autonomy

CommandActionPermission
/autonomy onEnable autonomous mode (slash-only)Administrator
/autonomy offDisable autonomous mode (slash-only)Administrator
/autonomy frequency <low/default/high>Set the confidence threshold for autonomous repliesAdministrator
Autonomous mode uses a confidence-scored intent evaluator — not random chance. Thresholds: low = 0.70, default = 0.50, high = 0.35. A 120-second per-channel cooldown and a 60-second per-user cooldown prevent the bot from dominating a conversation.

Moderation

CommandActionPermission
~purge <limit>Delete messages (1–1000)Manage Messages
~kick <member> [reason]Kick a memberKick Members
~ban <user> [delete_messages] [reason]Ban a user; optionally delete message history (e.g. 7d)Ban Members
~softban <member> [delete_messages] [reason]Ban and immediately unban to purge messages (default: 7d)Ban Members
~unban <user> [reason]Unban a userBan Members
~timeout <member> <duration> [reason] (~to)Timeout a member (e.g. 10m, 1h)Moderate Members
~removetimeout <member> (~rt, ~rto)Remove a timeoutModerate Members
~slowmode <duration|off>Set slowmode delay for the current channelManage Channels
~lock [reason]Lock the current channelManage Channels
~unlock [reason]Unlock the current channelManage Channels
~warn <member|id> [reason]Issue a warning with a unique hex IDModerate Members
~warns <member|id>Show all warnings for a memberModerate Members
~delwarn <warn_id>Delete a warning by its hex IDModerate Members
~clearwarns <member|id>Clear all warnings for a memberModerate Members
~warnthresholds (~wt)View or edit auto-punishment thresholds via modalAdministrator
Warn thresholds support timeout <duration>, kick, and ban actions triggered at configurable warning counts. Configure them with ~warnthresholds, which opens a modal.

Utility & Fun

CommandActionPermission
~help [command]Show help for commandsAnyone
~prefix <symbol>Change the command prefixAdministrator
~math <equation>Solve an equation via Wolfram|AlphaAnyone
~download <url> (~dl)Download a video (1080p → 720p → 480p → compressed)Anyone
~audio <url> (~mp3)Download audio as MP3Anyone
~pingShow bot and Discord API latencyAnyone
~helloSay hello backAnyone
~randommemberRandomly select a server memberMention Everyone
~coinflipFlip a coinAnyone
~roll [sides]Roll a die (default: 6 sides)Anyone
~pick <choice1, choice2, ...>Pick randomly from comma-separated choicesAnyone