Slash Commands

Slash Commands

Complete reference for every VexAI slash command: subcommands, options, permissions, and usage details.

Overview

VexAI registers a rich set of slash commands that let you manage users, switch models, toggle systems, and configure the bot at runtime, all from Discord's native command interface.

â„šī¸ Permissions

Most commands are restricted to the bot owner (the user IDs listed in ADMIN_USER_IDS). Commands that require owner access are marked below.

/allow: Manage Allowed Users

Control which users are permitted to interact with the bot. Owner only.

SubcommandOptionsDescription
adduserAdd a user to the allowed list
removeuserRemove a user from the allowed list
list-Show all allowed users

/model: Per-User Model Overrides

Assign different LLM providers and models to individual users. Useful for giving power users access to stronger models while keeping costs low for everyone else.

SubcommandOptionsDescription
setuser, provider, model, api_key, base_urlSet a user's model override
removeuserRemove a user's override
list-Show all active overrides
💡 Tip

The api_key and base_url options are optional. If omitted, the override inherits the bot's default credentials for the chosen provider.

/mode: Mode Presets

Quickly switch between predefined LLM configurations optimized for speed, cost, balance, or quality.

SubcommandOptionsDescription
setmode: fast, cheap, balanced, qualitySwitch to a preset
clear-Clear current mode preset
status-Show active mode
list-Show all available presets

/observer: Security Observer

Toggle the security observer that reviews every tool call before execution. When enabled, a separate LLM call approves, denies, or escalates each action.

SubcommandDescription
enableEnable the security observer
disableDisable the security observer
resetReset observer configuration
statusShow observer status and stats
âš ī¸ Warning

Disabling the observer removes the safety net for destructive tool calls (bans, role deletions, etc.). Only disable in trusted environments.

/set-iterations: Tool Call Limits

Control how many tool calls the bot can make per message before stopping.

OptionDescription
countMax tool calls per message (default: 20)
â„šī¸ Note

Higher iteration counts allow the bot to complete more complex multi-step tasks, but also increase latency and token usage per message.

/imagegen: AI Image Generation

Enable or disable AI image generation and configure the model used.

SubcommandOptionsDescription
enable-Enable image generation
disable-Disable image generation
modelmodelSet the generation model
status-Show current settings

/config: Runtime Configuration

View and modify the bot's configuration at runtime using dot-notation paths. Sensitive values (API keys, tokens) are automatically masked in output.

SubcommandOptionsDescription
viewsection (optional)View config (sensitive values masked)
setkey, valueSet config value with dot notation
resetkeyReset to schema default
💡 Tip

Use dot notation for nested keys: /config set key:voice.tts.provider value:local

/agents: Agent Management

List, inspect, toggle, and delete agents created through the agent system.

SubcommandOptionsDescription
list-List all agents
infonameShow agent details
deletenameDelete an agent
togglenameEnable/disable an agent

/subagents: Sub-Agents System

Enable or disable the sub-agents system that allows agents to spawn child agents for parallel task execution.

SubcommandDescription
enableEnable sub-agents
disableDisable sub-agents
statusShow sub-agent system status

/workflows: Workflow Engine

Toggle the DAG-based workflow engine on or off.

SubcommandDescription
enableEnable workflows
disableDisable workflows
statusShow workflow engine status

/sync: Message Database Sync

Monitor and manage the background sync that indexes Discord messages into the database for search and context retrieval.

SubcommandOptionsDescription
status-Show sync progress or "SYNC COMPLETE"
rescandaysRe-scan recent messages to fill gaps

/migrate: Database Migration

Check database status or migrate all data from SQLite to PostgreSQL.

SubcommandDescription
statusShow backend info and row counts
to-postgresMigrate all data from SQLite to PostgreSQL
âš ī¸ Warning

The to-postgres migration is a one-way operation. Back up your SQLite database before running it.

/credits: Check OpenRouter Balance

Displays your current OpenRouter API credit balance. Only relevant when using the OpenRouter LLM provider.

/restart: Force Restart

Force-restarts the bot process. Owner only.

🚨 Caution

This immediately terminates and restarts the process. Any in-flight operations (voice sessions, pending tool calls) will be interrupted.

Permissions Summary

â„šī¸ Who Can Run What

All commands except /credits require bot owner permissions (your user ID must be in ADMIN_USER_IDS). The /allow command gates which non-owner users can interact with the bot at all, while the remaining commands control bot behavior and configuration.