Documentation
Commands Reference
Every GuildScript slash command: what it does, its options, the permissions it requires, and how plans affect it.
GuildScript has 13 slash commands. Commands marked Administrator are hidden from members without the Administrator permission (server admins can adjust this per command in Discord's integration settings). All command responses are ephemeral: only the person who ran the command sees them.
A single shared cooldown applies per user across all commands: 10 seconds on the Free plan and 2.5 seconds with Premium. If you run commands too quickly the bot tells you how long to wait.
Overview
| Command | Permission | What it does |
|---|---|---|
/initialize | Administrator | Set up the server so it can hold agents. Run once. |
/agents | Administrator | Create, update, download, and delete agents. |
/uninitialize | Administrator | Delete the server setup and all its data. |
/vibe-code-agent | Administrator | Have a connected AI write an agent from a prompt. |
/database | Administrator | Connect, inspect, replace, or remove a MongoDB database. |
/llm | Administrator | Connect and manage AI provider API keys. |
/profile | Administrator | View plan, agents, quota usage, and limits for this server. |
/premium | Everyone | View plans, buy Premium, or cancel a subscription. |
/payment-status | Everyone | Check the status of a Premium payment. |
/help | Everyone | Browse every command with usage instructions. |
/docs | Everyone | Get a link to this documentation. |
/discord | Everyone | Get an invite to the support server. |
/ping | Everyone | Check the bot's latency. |
Setup commands
/initialize
Initialize agents in your server. Run this before the /agents command. Permission: Administrator. Options: none.
This registers the server to your Discord account and creates the storage record that holds its agents and database connection. You run it once per server. The number of servers you can initialize depends on your plan: 10 on Free, 50 with Premium. The count is tied to the user who ran /initialize, so the same account owns all of its servers' plans.
If your Premium expired, your servers are disabled. Running /initialize again in a disabled server reactivates it on the Free plan (up to the Free server limit), with only your first 6 agents enabled.
/agents
View and manage this server's agents. Permission: Administrator. Options: none.
Opens the agent manager: a select menu listing every agent plus Create New, Update, Download Agent, and Delete buttons. Clicking Create New (or Update) opens a form with four fields:
- Agent Name (required, 1 to 32 characters).
- Event (required): one of the 15 supported events, chosen from a dropdown.
- Error Channel (optional): a text channel where the agent's runtime errors are reported. The bot needs View Channel, Send Messages, and Embed Links there.
- Code File (required): a single
.jsfile, up to 24 KiB on Free or 128 KiB with Premium.
- Create New adds an agent, up to your plan's limit (6 per server on Free, 24 with Premium).
- Update replaces an existing agent's name, event, error channel, and code in one step. The code file must be re-uploaded.
- Download Agent sends you the agent's source file with a metadata header (name, event, IDs), useful for backups and for editing the latest version.
- Delete asks for confirmation, then removes the agent permanently.
If you downgrade from Premium with more than 6 agents on a server, the first 6 (in creation order) keep running and the rest are marked disabled. Disabled agents cannot be edited, only downloaded or deleted, until you upgrade again or delete others to get under the limit.
/uninitialize
Remove agents setup from your server. Permission: Administrator. Options: none.
Asks for confirmation, then deletes everything GuildScript stores for the server: the database connection, all agents, and all scripts. This is irreversible and frees one server slot on your plan. If you only want to manage one piece, use /agents, /database, or /llm instead.
Building commands
/vibe-code-agent
Describe an agent and let your connected AI write it for you. Permission: Administrator.
| Option | Type | Required | Description |
|---|---|---|---|
prompt | String (max 3048 chars) | Yes | Describe what the agent should do. |
Requires at least one AI provider connected with /llm. The bot shows a button per connected provider (Groq, Mistral, Gemini); pick one and it generates up to 5 ready-to-upload agent files, each tagged with the event to select when you upload it via /agents. Generation uses your own API key. The prompt is held for 10 minutes; after that, run the command again. See the Vibe Coding guide for how to get good results.
/database
Connect a MongoDB database. The connection string is stored in encrypted form. Permission: Administrator. Options: none.
With no database connected, it shows a Connect Database button that opens a form for your connection string. With one connected, it shows Status, Replace Database, and Remove Database buttons. Requirements for the connection string:
- Must be a
mongodb+srv://URI (MongoDB Atlas only). - Must include a username and password.
- The host must be an
*.mongodb.netaddress that resolves to public IPs.
The URI is encrypted with AES-256-GCM before storage, is never displayed back, and is never visible to agent code. Agents reach the database only through the db helper described in Lesson 9.
/llm
Connect an LLM provider for vibe-coding scripts or for use inside your scripts. Permission: Administrator. Options: none.
Lets you add, update, or remove API keys for Groq, Mistral, and Gemini. You can connect several providers at once. Keys are stored encrypted and are never shown back or exposed to agent code; agents call providers through the llm.chat() helper described in Lesson 11.
Account and plan commands
/profile
View this server's GuildScript profile, quotas, plans and more. Permission: Administrator. Options: none.
Shows your plan and subscription status (with renewal date), this server's status, agent count against the limit, whether a database and LLM providers are connected, live usage bars for the per-minute, per-hour, and per-day run quotas, and your plan's rate limits and resource limits.
/premium
Access higher limits and more agents with GuildScript premium plans. Permission: everyone. Options: none.
Shows Check Premium Plan and Check Free Plan buttons with each plan's full limits. From the Premium view you can click Buy Now to get a secure Razorpay payment link (USD 12 per month), or Cancel Plan if you are subscribed. Cancelling asks you to type a confirmation phrase so it cannot happen by accident; you keep Premium until the end of the paid period.
/payment-status
Check your payment status if you have paid for premium. Permission: everyone. Options: none.
Reports one of four states: active (subscription running), pending (payment processing; Premium access is granted in the meantime), halted (auto-renew failed; renew via /premium), or cancelled (access continues until the paid period ends).
Utility commands
/help
Browse every command, what it does, and how to use it. Permission: everyone. Options: none. Opens an overview of all commands grouped by required permission, with a dropdown that explains each command and its permissions in detail.
/docs
Learn GuildScript: agents, events, database, AI, and more. Permission: everyone. Options: none. Replies with a button linking to this documentation site.
/discord
Join our Discord server if you want help. Permission: everyone. Options: none. Replies with an invite button to the official support server.
/ping
Pong! Permission: everyone. Options: none. Replies with the bot's current websocket latency in milliseconds, useful to confirm the bot is online.