Commands

8f623f8b4ee4e7e1c12e6698a

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
gpt User
▼
Description
Query the GPT-5-nano model for concise factual answers.
Usage
cq-gpt <question>
Examples
Ask a question to the GPT-5-nano model.
DumbKitty307: cq-gpt What is the capital of France?
CatQuery: Paris
presence User
▼
Description
Updates 7TV presence. If no username is provided, updates your own presence. Otherwise, updates the specified user's presence.
Usage
cq-presence [username]
Examples
Update your own 7TV presence.
PoopingPants55: cq-presence
CatQuery: ✅ Presence updated.
Update 7TV presence for user 'farty'.
SmellyKitty397: cq-presence farty
CatQuery: ✅ Presence updated for farty.
Update 7TV presence with @ symbol.
PoopyUnicorn600: cq-presence @farty
CatQuery: ✅ Presence updated for farty.
live User
▼
Description
Controls Twitch stream processes. Regular users control their own stream. Admins can optionally specify a username to control any user's stream.
Aliases
stream
Usage
cq-live <start|stop|restart|change|list> [username] [videoId]
Examples
Start your stream with a specific video.
SmellyPhoenix101: cq-live start mc
CatQuery: ✅ Started stream for yourname with video mc
Start your stream with any available video.
PoopyUnicorn411: cq-live start
CatQuery: ✅ Started stream for yourname with video night
Stop your running stream.
PoopyNoodle843: cq-live stop
CatQuery: ✅ Stopped stream for yourname
Restart your stream with the same video.
SmellyPants769: cq-live restart
CatQuery: ✅ Restarted stream for yourname
Change the video being streamed.
FartyIgloo420: cq-live change alt
CatQuery: ✅ Changed stream for yourname to video alt
List available videos for your stream.
StinkyNoodle316: cq-live list
CatQuery: 📹 Available videos for yourname: alt, mc, night
(Admin) Start a stream for another user.
FartyPhoenix302: cq-live start catquery mc
CatQuery: ✅ Started stream for catquery with video mc
(Admin) List available videos for another user.
PoopingPhoenix339: cq-live list catquery
CatQuery: 📹 Available videos for catquery: alt, mc, night
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.
Aliases
u
Usage
cq-user <username>
Examples
Get info for the Twitch user 'farty'.
PoopingPhoenix378: 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.
SmellyDragon918: cq-ping
CatQuery: 📌 Uptime: 2h 34m | Memory: 156.3 MB | CPU: 2.5% | Channels Joined: 42 | WS: 3 | msgs/min: 1234 | Messages this session: 5,100
help User
▼
Description
View available commands
Usage
cq-help
Examples
View available commands
StinkyKitty735: cq-help
CatQuery: 🔗 https://8f623f8b4ee4e7e1c12e6698a.catquery.com/commands
summarize User
▼
Description
Summarize recent chat messages from a Twitch channel.
Aliases
summary
Usage
cq-summarize [channel] [count]
Examples
Summarize recent messages from current channel (defaults to 100).
PoopyPants146: cq-summarize
CatQuery: Streaming tech and code discussions.
Summarize the last 10 messages from current channel.
DumbUnicorn138: cq-summarize 10
CatQuery: Build issues and deployment strategies.
Summarize the last 100 messages from a specific channel.
DumbPhoenix29: cq-summarize potatbotat 100
CatQuery: WebRTC, HackerNews posts, and Pion library implementations.
Summarize recent messages from a specific channel (defaults to 100).
StupidIgloo664: cq-summarize potatbotat
CatQuery: Streaming tech and code discussions.
Summarize messages from a numeric username with @ symbol.
PoopingIgloo194: cq-summarize @1234 50
CatQuery: Gaming and tech topics.
namechange User
▼
Description
Retrieves the username change history for a specified Twitch user.
Aliases
nc, namechanges
Usage
cq-namechange <username>
Examples
Get username change history for user 'farty'.
SmellyPhoenix651: cq-namechange farty
CatQuery: 📝 Username changes for farty: oldname1 → oldname2 (2025-01-15), oldname2 → farty (2025-02-20)
lastwatched User
▼
Description
Shows the last movie or TV episode a user watched via their linked Trakt account.
Aliases
lw
Usage
cq-lastwatched [username] [-link]
Examples
Check the last watched item for a user.
StupidPants650: cq-lastwatched catquery
CatQuery: catquery has watched: movie "Inception (2010)"
Check your own last watched item.
DumbNoodle719: cq-lastwatched
CatQuery: catquery has watched: movie "Inception (2010)"
Check the last watched item with a watch link.
StinkyCat958: cq-lastwatched catquery -link
CatQuery: catquery has watched: movie "Inception (2010)" | Watch: https://example.com/abc
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
SmellyIgloo30: cq-countlive 5000
CatQuery: ✅ There are 42 live channels with at least 5,000 viewers.
ban Moderator
▼
Description
Bans a user from using bot commands.
Usage
cq-ban <username>
Examples
Ban a user from using bot commands
StinkyUnicorn909: cq-ban someuser
CatQuery: 🚫 Banned someuser from using bot commands.
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
PoopingPants13: cq-channel join username
CatQuery: ✅ Successfully joined channel 'username' with priority '1'.
Join a channel with specified priority
PoopyNoodle377: cq-channel join username 3
CatQuery: ✅ Successfully joined channel 'username' with priority '3'.
Part a channel
PoopingUnicorn535: cq-channel part username
CatQuery: ✅ Successfully parted 1 channel 'username'
Join all logged channels (Priority argument is ignored)
FartingDragon280: cq-channel join logged
CatQuery: ✅ Successfully added X channels. Joining on next cycle.
restart Admin
▼
Description
Restarts the bot process.
Usage
cq-restart
Examples
Restart the bot and notify the channel.
PoopingUnicorn760: cq-restart
CatQuery: 🔄 Restarting...
reboot Admin
▼
Description
Reboots the VM.
Usage
cq-reboot
Examples
Reboot the VM and notify the channel.
PoopyDragon534: cq-reboot
CatQuery: 🔃 Rebooting...
rejoinfailed Admin
▼
Description
Resets the priority of failed channels and triggers a rejoin attempt on the next cycle.
Usage
cq-rejoinfailed
Examples
Reset priorities and rejoin all channels that previously failed to join.
FartyCat199: cq-rejoinfailed
CatQuery: ✅ Reset priorities and rejoining failed channels on next cycle.
unban Admin
▼
Description
Unbans a user, allowing them to use bot commands again.
Usage
cq-unban <username>
Examples
Unban a user and restore their access
DumbPants191: cq-unban someuser
CatQuery: ✅ Unbanned someuser. Their level has been set to: User (1)
cache Superuser
▼
Description
Updates the local cache of 7TV cosmetics, Twitch badges, stream videos, channel settings, and/or usernames.
Usage
cq-cache [cosmetics|streams|settings|usernames|all]
Examples
Update all caches (default)
PoopyNoodle920: cq-cache
CatQuery: ✅ Cache updated successfully.
Update only cosmetics cache
PoopingPhoenix934: cq-cache cosmetics
CatQuery: ✅ Cosmetics cache updated successfully.
Update only stream videos cache
FartingPants821: cq-cache streams
CatQuery: ✅ Stream videos cache updated successfully.
Update only channel settings cache
DumbKitty853: cq-cache settings
CatQuery: ✅ Channel settings cache cleared successfully.
Update only usernames cache
FartyDragon29: cq-cache usernames
CatQuery: ✅ Usernames cache cleared successfully.
Update all caches explicitly
FartyPants137: cq-cache all
CatQuery: ✅ Cache updated successfully.
code Superuser
▼
Description
Redeem a 7TV code.
Usage
cq-code <code>
Examples
Redeem a 7TV code.
PoopingPhoenix298: 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
DumbKitty565: cq-cosmetic 7tv badge <badge_name>
CatQuery: ✅ Cosmetic updated successfully.
Change your 7TV paint
StinkyPants742: cq-cosmetic 7tv paint <paint_name>
CatQuery: ✅ 7TV paint changed to <paint_name>
Turn off your Twitch badge.
FartyNoodle187: cq-cosmetic twitch badge off
CatQuery: ✅ Twitch badge turned off
Change your Twitch username color.
StupidPhoenix533: cq-cosmetic twitch color #FF0000
CatQuery: ✅ Twitch color changed to #FF0000
Turn off your 7TV paint.
PoopyPants773: cq-cosmetic 7tv paint off
CatQuery: ✅ 7TV paint turned off
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
PoopyIgloo56: cq-profile 7tv paint rainbow 10000
CatQuery: ✅ Successfully updated 2 setting(s).
Set 7TV badge profile to cycle through badges, no timer change
PoopyKitty806: cq-profile 7tv badge cycling
CatQuery: ✅ Successfully updated 1 setting(s).
Change only the 7TV paint timer to 15 seconds without changing profile
PoopyCat846: cq-profile 7tv paint 15000
CatQuery: ✅ Successfully updated 1 setting(s).
Set Twitch badge profile with flags for custom behavior
SmellyDragon430: 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
PoopingPants177: cq-profile twitch color spectrum 20000
CatQuery: ✅ Successfully updated 2 setting(s).
Disable 7TV paint by setting profile to 'off'
FartyPants111: cq-profile 7tv paint off
CatQuery: ✅ Successfully updated 1 setting(s).
Set 7TV badge with multiple flags for advanced control
SmellyIgloo134: cq-profile 7tv badge founder -loop -randomize
CatQuery: ✅ Successfully updated 1 setting(s).
sql Superuser
▼
Description
Executes a SQL query against the database.
Usage
cq-sql <SQL statement>
Examples
Select all users from the users table.
PoopyDragon178: 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.
SmellyKitty508: 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.
SmellyKitty199: 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.
FartingKitty237: 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
DumbPhoenix916: 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.
PoopingDragon41: cq-points some_channel
CatQuery: 💰 You have 1000 channel points in some_channel
potat Superuser
▼
Description
Run a Potat command via the Potat API.
Aliases
p
Usage
cq-potat <command>
Examples
Run a Potat command.
PoopingKitty103: cq-potat js 2 + 2
CatQuery: 4
level Superuser
▼
Description
Check or set a user's permission level.
Aliases
lvl
Usage
cq-level <username> [level]
Examples
Check a user's level
PoopyDragon336: cq-level some_user
CatQuery: 🔰 some_user's level is: Moderator (2)
Set a user's level to Admin
FartyPants503: cq-level some_user 3
CatQuery: ✅ Set some_user's level to: Admin (3)
joinlive Superuser
▼
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
PoopingNoodle217: cq-joinlive 10000
CatQuery: ✅ Successfully joined 25 live channels with at least 10,000 viewers.