8f623f8b4ee4e7e1c12e6698a

Commands

Add the Bot

Add the bot as a moderator:

/mod 8f623f8b4ee4e7e1c12e6698a

📚 Command Flags

▼

Commands support the following global flags (SUPERUSER only):

-s Silent mode - suppresses command response messages
-me Selfbot mode - sends the message as the selfbot instead of the bot

💡 Some commands may also support their own specific flags (e.g., -reverse, -loop). Check individual command documentation for details.

🔗 Command Piping

▼

Commands can be piped together to chain operations (SUPERUSER only). Use the | character to separate commands. Output from each command becomes available for substitution in subsequent commands.

command1 | command2
Chain commands together. Output is not automatically passed; use {0}, {1}, etc. to reference previous outputs
{0}, {1}, {2}
Reference the 1st, 2nd, 3rd word from the immediate previous command's output
{1+}
All words from position 1 onwards from the immediate previous output
{^0}, {^1+}
Reference parent command's output (the command before the previous one)
{^^0}, {^^1+}
Reference grandparent command's output (two commands before the previous one)
{[0]0}, {[1]2}, {[2]3+}
Reference output from a specific pipe by index: {[pipe_index]word_index} or {[pipe_index]word_index+}
\{0}
Escape braces with backslash to use literal {0} instead of substitution
```code here```
Wrap code blocks in triple backticks to preserve them during piping (backticks are stripped from output)
Examples:
cq-user farty | send {0} Hello user {1}!
Gets user info, then sends a message to that user's channel
cq-sql ```SELECT * FROM users``` | send mychannel {0}
Runs SQL query (preserving it with backticks), then sends result to a channel
user User
▼
Description
Fetches information about a Twitch user, including their user ID, username, account creation date, permission level, and the number of logged name changes.
Usage
cq-user <username>
Examples
Get info for the Twitch user 'farty'.
SmellyPhoenix832: cq-user farty
CatQuery: 👤 ID: 123456 | Username: farty | Created: 2011-03-16T17:06:00Z | Level: Moderator (2) | Name changes logged: 2
ping User
▼
Description
Ping the bot to get its current status.
Usage
cq-ping
Examples
Ping the bot.
PoopyDragon756: cq-ping
CatQuery: 📌 Uptime: 2h 34m | Memory: 156.3 MB | CPU: 2.5% | Channels: 42 / 50
help User
▼
Description
View available commands
Usage
cq-help
Examples
View available commands
FartyKitty535: cq-help
CatQuery: 🔗 https://8f623f8b4ee4e7e1c12e6698a.catquery.com
gpt Moderator
▼
Description
Query the GPT-4o-mini model for concise factual answers.
Usage
cq-gpt <question>
Examples
Ask a question to the GPT-4o-mini model.
PoopingDragon213: cq-gpt What is the capital of France?
CatQuery: Paris
countlive Moderator
▼
Description
Count live channels with at least a specified viewer count.
Usage
cq-countlive <viewer_threshold>
Examples
Count live channels with at least 5000 viewers
FartingPants783: cq-countlive 5000
CatQuery: ✅ There are 42 live channels with at least 5,000 viewers.
channel Admin
▼
Description
Join or part Twitch channels. Priority defaults to 1.
Usage
cq-channel <join|part> <username|logged> <priority>?
Examples
Join a channel with default priority
FartyCat909: cq-channel join username
CatQuery: ✅ Successfully joined channel 'username' with priority '1'.
Join a channel with specified priority
StupidIgloo663: cq-channel join username 3
CatQuery: ✅ Successfully joined channel 'username' with priority '3'.
Part a channel
DumbPants806: cq-channel part username
CatQuery: ✅ Successfully parted 1 channel 'username'
Join all logged channels (Priority argument is ignored)
FartyIgloo936: cq-channel join logged
CatQuery: ✅ Successfully added X channels. Joining on next cycle.
restart Admin
▼
Description
Restarts the bot process. Can be used by administrators to apply updates or recover from issues.
Usage
cq-restart
Examples
Restart the bot and notify the channel.
FartingKitty338: cq-restart
CatQuery: 🔄 Restarting...
stream Admin
▼
Description
Controls Twitch stream services via systemd. Allows administrators to start, stop, or restart supported stream services.
Usage
cq-stream <start|stop|restart> <rain|cattv>
Examples
Restart the 'rain' Twitch stream service.
FartingNoodle600: cq-stream restart rain
CatQuery: ✅ Executed restart command on rain
rejoinfailed Admin
▼
Description
Resets the priority of failed channels and triggers a rejoin attempt on the next cycle. Useful for admins to manually retry joining channels that previously failed.
Usage
cq-rejoinfailed
Examples
Reset priorities and rejoin all channels that previously failed to join.
PoopingIgloo756: cq-rejoinfailed
CatQuery: ✅ Reset priorities and rejoining failed channels on next cycle.
joinlive Admin
▼
Description
Join live channels with at least a specified viewer count.
Usage
cq-joinlive <viewer_threshold>
Examples
Join live channels with at least 10000 viewers
FartyNoodle10: cq-joinlive 10000
CatQuery: ✅ Successfully joined 25 live channels with at least 10,000 viewers.
cache Superuser
▼
Description
Updates the local cache of 7TV cosmetics and Twitch badges.
Usage
cq-cache
Examples
Update the local cache of cosmetics and badges
StinkyNoodle729: cq-cache
CatQuery: ✅ Cache updated successfully.
code Superuser
▼
Description
Redeem a 7TV code.
Usage
cq-code <code>
Examples
Redeem a 7TV code.
StinkyCat577: cq-code ABC123
CatQuery: ✅ Code redeemed.
cosmetic Superuser
▼
Description
Update your cosmetics for 7TV and Twitch.
Usage
cq-cosmetic <platform> <type> <value>
Examples
Change your 7TV badge
SmellyIgloo332: cq-cosmetic 7tv badge <badge_name>
CatQuery: ✅ Cosmetic updated successfully.
Change your 7TV paint
PoopingDragon553: cq-cosmetic 7tv paint <paint_name>
CatQuery: ✅ 7TV paint changed to <paint_name>
Turn off your Twitch badge.
StinkyPants704: cq-cosmetic twitch badge off
CatQuery: ✅ Twitch badge turned off
Change your Twitch username color.
StinkyUnicorn526: cq-cosmetic twitch color #FF0000
CatQuery: ✅ Twitch color changed to #FF0000
Turn off your 7TV paint.
FartingPhoenix548: cq-cosmetic 7tv paint off
CatQuery: ✅ 7TV paint turned off
presence Superuser
▼
Description
Updates 7TV presence.
Usage
cq-presence
Examples
Update 7TV presence.
DumbCat15: cq-presence
CatQuery: ✅ Presence updated.
profile Superuser
▼
Description
Set profile settings for different platforms and types.
Usage
cq-profile <platform> <type> [profile|time] [time] [flags]
Examples
Set 7TV paint profile to 'rainbow' and update every 10 seconds
FartingPants654: cq-profile 7tv paint rainbow 10000
CatQuery: ✅ Successfully updated 2 setting(s).
Set 7TV badge profile to cycle through badges, no timer change
FartyIgloo926: cq-profile 7tv badge cycling
CatQuery: ✅ Successfully updated 1 setting(s).
Change only the 7TV paint timer to 15 seconds without changing profile
StupidDragon151: cq-profile 7tv paint 15000
CatQuery: ✅ Successfully updated 1 setting(s).
Set Twitch badge profile with flags for custom behavior
StinkyPhoenix610: cq-profile twitch badge premium -reverse -skip
CatQuery: ✅ Successfully updated 1 setting(s).
Set Twitch color profile to 'spectrum' and change timer to 20 seconds
DumbUnicorn986: cq-profile twitch color spectrum 20000
CatQuery: ✅ Successfully updated 2 setting(s).
Disable 7TV paint by setting profile to 'off'
SmellyNoodle603: cq-profile 7tv paint off
CatQuery: ✅ Successfully updated 1 setting(s).
Set 7TV badge with multiple flags for advanced control
PoopyPhoenix529: cq-profile 7tv badge founder -loop -randomize
CatQuery: ✅ Successfully updated 1 setting(s).
sql Superuser
▼
Description
Executes a raw SQL query against the database. Only available to superusers. Supports SELECT, INSERT, UPDATE, and DELETE operations.
Usage
cq-sql <SQL statement>
Examples
Select all users from the users table.
PoopingDragon77: cq-sql SELECT * FROM users
CatQuery: {"rows":2,"results":[{"id":1,"name":"Alice"},{"id":2,"name":"Bob"}]}
pull Superuser
▼
Description
Pull the latest bot files and restart the bot.
Usage
cq-pull
Examples
Pull the latest bot files.
PoopyUnicorn532: cq-pull
CatQuery: 🔄 Pulling latest artifacts... <update message> Restarting...
name Superuser
▼
Description
Updates Twitch display name.
Usage
cq-name <display_name>
Examples
Change the Twitch display name.
SmellyIgloo853: cq-name CatQuery
CatQuery: ✅ Display name updated
send Superuser
▼
Description
Sends a message to a specified Twitch channel as the bot or selfbot.
Usage
cq-send <channel> <message>
Examples
Send 'Hello, world!' to the channel 'mychannel' as the bot.
PoopyIgloo910: cq-send mychannel Hello, world!
CatQuery: Message sent to mychannel
bits Superuser
▼
Description
Get your Twitch bit balance
Usage
cq-bits
Examples
Get your bit balance
PoopyPhoenix465: cq-bits
CatQuery: 💰 You have 1000 bits
points Superuser
▼
Description
Get your channel points balance.
Usage
cq-points <channel>
Examples
Get channel points for a channel.
PoopyNoodle241: cq-points some_channel
CatQuery: 💰 You have 1000 channel points in some_channel
potat Superuser
▼
Description
Run a Potat command via the Potat API.
Usage
cq-potat <command>
Examples
Run a Potat command.
DumbUnicorn906: cq-potat js 2 + 2
CatQuery: 4
level Superuser
▼
Description
Check or set a user's permission level.
Usage
cq-level <username> [level]
Examples
Check a user's level
SmellyPhoenix516: cq-level some_user
CatQuery: 🔰 some_user's level is: Moderator (2)
Set a user's level to Admin
SmellyCat822: cq-level some_user 3
CatQuery: ✅ Set some_user's level to: Admin (3)