By default, the bot uses
cc! or mention as command prefix. This means that commands are invoked by doing
cc!command arguments... or
@Companion Cube command arguments....
In below documentation, all commands will be listed with default command prefix. Arguments will be listed as
<argument>, denoting required argument;
denoting required catch-all argument (i.e. one that can take more than one value). Optional arguments will be denoted using
[argument...] for single and catch-all
optional arguments. When typing commands, you must omit the
 parts, meaning that if a command is denoted as
cc!command <argument 1> [argument 2],
you use it as
cc!command value1 value2 or
cc!command value1. If you want to pass an argument that contains spaces, wrap it in
"", for instance:
cc!command "value for argument 1" will invoke
cc!command with a single argument,
value for argument 1. This is not required for catch-all arguments. For instance, if a
command is declared as
cc!echo <message...>, you can invoke it as
cc!echo Hello, this is a message with spaces!.
cc!help [command] Displays help. Invoking this command without any arguments will list available top-level. Specifying a command will show information about that command, and its subcommands
Companion Cube features a blocking system. Blocking can happen on per-guild, per-channel, and per-user basis. Blocked users cannot use the bot's passive or active functionality. Messages from blocked guilds and channels are ignored (this excludes administrative commands).
Companion Cube's command prefix can be changed on per-guild or per-channel basis, where channel settings override guild settings. The mention prefix, however, cannot be changed or disabled.
cc!admin nick [nickname...]Changes bot's nickname to one specified. Specifying an empty string (
"") or no argument will reset the nickname. Requires manage nicknames permission.
cc!admin prefix channel [new prefix...]Sets the current channel's command prefix. The prefix needs to be less than or 6 characters of length, and can consist of characters available on the standard US keyboard. Specifying an empty string (
"") or no argument will reset the prefix. Requires manage channel permission.
cc!admin prefix guild [new prefix...]Sets the current guild's command prefix. This is the same as channel prefix, but for an entire guild. Requires manage guild permission.
cc!admin channel blockcurrentBlocks the current channel from being processed by the bot. This means that no active or passive functionality (with the exception of bot control commands) can be used in this channel. Requires manage channel permission.
cc!admin channel unblockcurrentUnblocks the current channel from being processed by the bot. This re-enables all functionality for the channel. Requires manage channel permission.
At present, all tags are channel-specific tags. This means that when created in one channel, they cannot be called from any other one. Tags can be created by any user, however by default they are not shown in default listing. Moderators can approve or unapprove tags, which shows or hides them in default listing respectively. Moderators can also edit or delete any tag. The tag system features full tracking for all tags. This means that each tag has a use count, incremented when any user (excluding tag's owner) uses a tag, its use counter is incremented. Moreover, tags keep a full record of edits. Each edit to a tag records the timestamp, and the user who performed the action. Each tag's full history can be recalled at any time, including its previous versions. Deleting a tag, however, removes the tag along with its history.
cc!tag [tag name...]Displays the current version of specified tag. If the tag is not found, it displays 5 closest suggestions instead.
cc!tag create <name> <contents...>Creates a new tag with specified name and contents. By default, the tag will be hidden from default listing.
cc!tag delete <name...>Deletes the specified tag. This command requires that you own the tag.
cc!tag force_delete <name...>Moderator version of the above. It can delete any tag for current channel. This requires you have manage channel permissions.
cc!tag edit <name> <new contents...>Edits a specified tag, replacing its contents with the ones specified. This command requires that you own the tag.
cc!tag force_edit <name> <new contents...>Moderator version of the above. It can edit any tag for current channel. This requires you have manage channel permissions.
cc!tag history <name...>Views edit history for a given tag.
cc!tag view_edit <name> <edit id>Views specific revision of a given tag.
cc!tag dump <name...>Displays raw contents of specified tag, that is with all the markdown escaped.
cc!tag info <name...>Displays information about specified tag.
cc!tag approve <name...>Approves a tag, which enables it to be listed in default tag listing. Requires manage channel permission.
cc!tag unapprove <name...>Unapproves a tag, which prevents it from being listed in default tag listing. Requires manage channel permission.
cc!tag list [query...]Searches tags, and returns up to 5 tags with most similar names. If no query is specified, it shows default listing.
cc!tags [query...]Alias for the above.
The currency system of Companion Cube features a currency called Comedy Chevrons. Currency issue rate is 5% (that is, each message has a 5% chance of generating a single Comedy Chevron). Currency is global, that is each user's balance is available in all guilds. Ignored guilds, channels, and users do not generate currency. Bots cannot receive or hold currency, nor do they generate any.
cc!currency [user...]Displays current balance. If
useris specified, it shows that user's balance instead.
cc!currency send <user> <amount>Sends a specified amount of currency from your balance to target user's balance. Requires your balance to have the required amount, and the amount cannot be negative.
cc!aboutDisplays information about the bot, such as bot's website, invite link, etc.
cc!uptimeDisplays bot's current uptime.
cc!cleanupCleans up. This removes bot's messages found in the last 100 messages.