Commands

docs.catquery.com

← Docs

Add the Bot

The bot is likely listening in your channel already. Add the bot as a moderator to use commands.

/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 farty Hello user {4}!
Gets user info, then sends a message using the username word from the output
cq-sql ```SELECT * FROM users``` | send mychannel {0}
Runs SQL query (preserving it with backticks), then sends result to a channel
countlive User
▼
Description
Count live channels, optionally with at least a specified viewer count.
Usage
cq-countlive [viewer_threshold]
Examples
Count all live channels
FartyCat326: cq-countlive
CatQuery: There are 42 live channels with at least 0 viewers.
Count live channels with at least 5000 viewers
PoopyCat177: cq-countlive 5000
CatQuery: There are 42 live channels with at least 5,000 viewers.
gpt User
▼
Description
Query GPT model for concise factual answers.
Usage
cq-gpt <question>
Examples
Ask a question to the GPT model.
FartingPants558: cq-gpt What is the capital of France?
CatQuery: Paris
help User
▼
Description
View available commands, or get details on a specific command
Usage
cq-help [command]
Examples
View available commands
PoopyCat122: cq-help
CatQuery: https://docs.catquery.com/commands
View details for a specific command
PoopingPants755: cq-help summarize
CatQuery: https://docs.catquery.com/commands?cmd=summarize
join User
▼
Description
Joins your channel.
Usage
cq-join
Examples
Join your own channel
PoopingIgloo81: cq-join
CatQuery: The bot is already listening in your channel. Make sure the bot is a moderator to use commands.
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.
StupidDragon176: cq-lastwatched catquery
CatQuery: catquery has watched: movie "Inception (2010)"
Check your own last watched item.
FartingIgloo781: cq-lastwatched
CatQuery: catquery has watched: movie "Inception (2010)"
Check the last watched item with a watch link.
StupidIgloo278: cq-lastwatched catquery -link
CatQuery: catquery has watched: movie "Inception (2010)" | Watch: https://example.com/abc
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.
PoopingKitty423: cq-live start mc
CatQuery: Started stream for yourname with video mc
Start your stream with any available video.
PoopingPhoenix405: cq-live start
CatQuery: Started stream for yourname with video night
Stop your running stream.
FartingKitty836: cq-live stop
CatQuery: Stopped stream for yourname
Restart your stream with the same video.
SmellyIgloo263: cq-live restart
CatQuery: Restarted stream for yourname
Change the video being streamed.
PoopyUnicorn847: cq-live change alt
CatQuery: Changed stream for yourname to video alt
List available videos for your stream.
PoopingIgloo720: cq-live list
CatQuery: Available videos for yourname: alt, mc, night
(Admin) Start a stream for another user.
FartyKitty923: cq-live start catquery mc
CatQuery: Started stream for catquery with video mc
(Admin) List available videos for another user.
FartyCat837: cq-live list catquery
CatQuery: Available videos for catquery: alt, mc, night
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'.
DumbPhoenix290: cq-namechange farty
CatQuery: Known names for farty: oldname1, farty
ping User
▼
Description
Ping the bot to get its current status.
Usage
cq-ping
Examples
Ping the bot.
SmellyUnicorn239: cq-ping
CatQuery: Uptime: 2h 34m | Memory: 156.3 MB | CPU: 2.5% | Channels Joined: 42 | Firehose: 3 | msgs/min: 1,234 | Messages this session: 5,100
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.
PoopingUnicorn368: cq-presence
CatQuery: Presence updated.
Update 7TV presence for user 'farty'.
PoopyPants387: cq-presence farty
CatQuery: Presence updated for farty.
Update 7TV presence with @ symbol.
PoopyNoodle637: cq-presence @farty
CatQuery: Presence updated for farty.
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).
PoopingUnicorn611: cq-summarize
CatQuery: Streaming tech and code discussions.
Summarize the last 10 messages from current channel.
PoopingUnicorn322: cq-summarize 10
CatQuery: Build issues and deployment strategies.
Summarize the last 100 messages from a specific channel.
StinkyIgloo628: cq-summarize potatbotat 100
CatQuery: WebRTC, HackerNews posts, and Pion library implementations.
Summarize recent messages from a specific channel (defaults to 100).
PoopyDragon326: cq-summarize potatbotat
CatQuery: Streaming tech and code discussions.
Summarize messages from a numeric username with @ symbol.
SmellyPants919: cq-summarize @1234 50
CatQuery: Gaming and tech topics.
summarizetopic User
▼
Description
Summarize recent chat messages from the current channel focused on a specific topic.
Aliases
topic
Usage
cq-summarizetopic [count] <topic>
Examples
Summarize chat about a topic (defaults to 100 messages).
PoopyIgloo801: cq-summarizetopic webrtc and pion stuff
CatQuery: WebRTC and Pion library were discussed along with related networking topics.
Summarize the last 500 messages focused on a topic (count first).
DumbPhoenix859: cq-summarizetopic 500 webrtc and the 100 other ways to build IP stuff
CatQuery: WebRTC, HackerNews posts, and Pion library implementations.
Summarize with count at the end of the topic.
PoopyPhoenix120: cq-summarizetopic webrtc and pion stuff, github changes too 10
CatQuery: Recent WebRTC and Pion-related GitHub changes were discussed.
user User
▼
Description
Fetches information about a Twitch user, including their user ID, username, account creation date, permission level, and the number of known names.
Aliases
u
Usage
cq-user <username>
Examples
Get info for the Twitch user 'farty'.
PoopyNoodle306: cq-user farty
CatQuery: ID: 123456 | Username: farty | Created: 2011-03-16T17:06:00Z | Level: Moderator (2) | Known names: 2
ban Moderator
▼
Description
Ban a user from using bot commands.
Usage
cq-ban <username>
Examples
Ban a user from using bot commands.
PoopyIgloo873: cq-ban someuser
CatQuery: Banned someuser from using bot commands.
reboot Admin
▼
Description
Reboots the VM.
Usage
cq-reboot
Examples
Reboot the VM and notify the channel.
FartingCat850: 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.
PoopingUnicorn358: cq-rejoinfailed
CatQuery: Reset priorities and rejoining failed channels on next cycle.
restart Admin
▼
Description
Restarts the bot process, selected services, or all services.
Usage
cq-restart [chat|api|firehose|streams|redirects|proxy|all]
Examples
Restart the bot and notify the channel.
FartingPhoenix749: cq-restart
CatQuery: Restarting...
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
PoopyPants506: cq-unban someuser
CatQuery: Unbanned someuser. Their level has been set to: User (1)
247blockedterm Superuser
▼
Description
Add or remove blocked term(s) in all 24/7 channels.
Usage
cq-247blockedterm <add|remove> <term1> [term2 ...]
Examples
Add a blocked term to all 24/7 channels.
FartyPants259: cq-247blockedterm add badword
CatQuery: Done. Processed 12 channel(s) with 1 term(s).
Add multiple blocked terms to all 24/7 channels.
PoopingIgloo907: cq-247blockedterm add badword nastyphrase
CatQuery: Done. Processed 12 channel(s) with 2 term(s).
Remove a blocked term from all 24/7 channels.
FartyPhoenix356: cq-247blockedterm remove badword
CatQuery: Done. Processed 12 channel(s) with 1 term(s).
backup Superuser
▼
Description
Trigger a database backup.
Usage
cq-backup
Examples
Run a database backup immediately.
SmellyIgloo671: cq-backup
CatQuery: Database backup completed successfully.
bits Superuser
▼
Description
Get Twitch bit balance
Usage
cq-bits
Examples
Get your bit balance
FartingNoodle522: cq-bits
CatQuery: You have 1000 bits
cache Superuser
▼
Description
Updates the local caches.
Usage
cq-cache [cosmetics|eventbadges|streams|settings|usernames|mods|all]
Examples
Update all caches (default)
PoopyIgloo672: cq-cache
CatQuery: Cache updated successfully.
Update only cosmetics cache
PoopingDragon567: cq-cache cosmetics
CatQuery: Cosmetics cache updated successfully.
Update only event badges cache
StupidKitty148: cq-cache eventbadges
CatQuery: Event badges cache updated successfully.
Update only stream videos cache
FartingKitty323: cq-cache streams
CatQuery: Stream videos cache updated successfully.
Update only channel settings cache
DumbCat438: cq-cache settings
CatQuery: Channel settings cache cleared successfully.
Update only usernames cache
StinkyDragon259: cq-cache usernames
CatQuery: Usernames cache cleared successfully.
Sync moderated channels for crossban support
PoopingPhoenix480: cq-cache mods
CatQuery: Mod list synced. 1 channel(s) lapsed.
Update all caches explicitly
PoopyIgloo673: cq-cache all
CatQuery: Cache updated successfully.
channel Superuser
▼
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
PoopyUnicorn29: cq-channel join username
CatQuery: Successfully joined channel 'username' with priority '1'.
Join a channel with specified priority
StinkyPants397: cq-channel join username 3
CatQuery: Successfully joined channel 'username' with priority '3'.
Part a channel
SmellyCat151: cq-channel part username
CatQuery: Successfully parted 1 channel 'username'
Join all logged channels (Priority argument is ignored)
DumbPhoenix337: cq-channel join logged
CatQuery: Successfully added 5 channels. Joining on next cycle.
code Superuser
▼
Description
Redeem a 7TV code.
Usage
cq-code <code>
Examples
Redeem a 7TV code.
StinkyKitty607: cq-code ABC123
CatQuery: Code redeemed.
cosmetic Superuser
▼
Description
Update your cosmetics for 7TV or Twitch.
Usage
cq-cosmetic <platform> <type> <value>
Examples
Change your 7TV badge
FartyIgloo193: cq-cosmetic 7tv badge bunni
CatQuery: 7TV badge changed to Bunni
Change your 7TV paint
StinkyPhoenix621: cq-cosmetic 7tv paint candy cane
CatQuery: 7TV paint changed to Candy Cane
Turn off your Twitch badge.
PoopyUnicorn21: cq-cosmetic twitch badge off
CatQuery: Twitch badge turned off
Change your Twitch username color.
FartingNoodle200: cq-cosmetic twitch color #FF0000
CatQuery: Twitch color changed to #FF0000
Turn off your 7TV paint.
StupidUnicorn28: cq-cosmetic 7tv paint off
CatQuery: 7TV paint turned off
crossban Superuser
▼
Description
Ban one or more Twitch users across every opted-in crossban channel.
Usage
cq-crossban <username[,username2,...]> [reason...]
Examples
Crossban a single user from all opted-in channels.
FartyDragon356: cq-crossban troublesome chatter evasion
CatQuery: Crossbanned troublesome in 47/50 channel(s). (2 already banned, 1 error)
Crossban multiple users from all opted-in channels.
DumbCat978: cq-crossban bot1,bot2,bot3 mass follow bot
CatQuery: Crossbanned 3/3 users. Bans: 141/150. (2 already banned, 7 errors)
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
SmellyUnicorn15: cq-joinlive 10000
CatQuery: Successfully joined 25 live channels with at least 10,000 viewers.
level Superuser
▼
Description
Check or set a user's permission level.
Aliases
lvl
Usage
cq-level <username> [level]
Examples
Check a user's level
PoopyIgloo480: cq-level some_user
CatQuery: some_user's level is: Moderator (2)
Set a user's level to Admin
PoopingIgloo75: cq-level some_user 3
CatQuery: Set some_user's level to: Admin (3)
monitor Superuser
▼
Description
Manually add one or more users to the monitored users table.
Usage
cq-monitor [-crossban] <username[,username2,...]> <reason>
Examples
Monitor a user for a specific reason.
DumbNoodle272: cq-monitor @someuser Discord Scammer Bot
CatQuery: Now monitoring someuser - Reason: Discord Scammer Bot
Monitor multiple users for the same reason.
PoopyCat331: cq-monitor bot1,bot2,bot3 mass follow bot
CatQuery: Now monitoring 3 users - Reason: mass follow bot
Monitor a user and crossban them from opted-in channels.
FartyNoodle740: cq-monitor -crossban @someuser Discord Scammer Bot
CatQuery: Now monitoring someuser - Reason: Discord Scammer Bot. Crossbanned someuser in 47/50 channel(s).
name Superuser
▼
Description
Updates Twitch display name.
Usage
cq-name [display_name]
Examples
Change the Twitch display name.
FartyCat61: cq-name CatQuery
CatQuery: Display name updated
points Superuser
▼
Description
Get your channel points balance.
Usage
cq-points <channel>
Examples
Get channel points for a channel.
DumbIgloo261: 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.
FartingPhoenix211: cq-potat js 2 + 2
CatQuery: 4
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
DumbCat669: cq-profile 7tv paint rainbow 10000
CatQuery: Successfully updated 2 setting(s).
Set 7TV badge profile to cycle through badges, no timer change
FartingNoodle308: cq-profile 7tv badge cycling
CatQuery: Successfully updated 1 setting(s).
Change only the 7TV paint timer to 15 seconds without changing profile
SmellyCat556: cq-profile 7tv paint 15000
CatQuery: Successfully updated 1 setting(s).
Set Twitch badge profile with flags for custom behavior
SmellyPants679: 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
PoopyNoodle270: cq-profile twitch color spectrum 20000
CatQuery: Successfully updated 2 setting(s).
Disable 7TV paint by setting profile to 'off'
SmellyPants745: cq-profile 7tv paint off
CatQuery: Successfully updated 1 setting(s).
Set 7TV badge with multiple flags for advanced control
FartingDragon773: cq-profile 7tv badge founder -loop -randomize
CatQuery: Successfully updated 1 setting(s).
pull Superuser
▼
Description
Pulls latest build artifacts for selected services and restarts them.
Usage
cq-pull [chat|api|firehose|streams|redirects|proxy|all]
Examples
Pull the latest artifacts and restart all services.
PoopyNoodle443: cq-pull
CatQuery: Pulling latest artifacts... Successfully updated. Restarting all services...
restore Superuser
▼
Description
Restores vital database tables from backup files. Optionally specify table names to restore a subset, and/or pin specific backup files using table:filename syntax.
Usage
cq-restore [table1 [table2 ...]] [table:filename ...]
Examples
Restore all backed-up tables from their latest backups.
StupidDragon931: cq-restore
CatQuery: Restore complete: channels_permanent, channel_settings, levels, user_names, settings
Restore only the channels and levels tables.
FartingPants209: cq-restore channels_permanent levels
CatQuery: Restore complete: channels_permanent, levels
Restore channels from a specific backup file, levels from latest.
DumbNoodle169: cq-restore channels_permanent:channels_permanent-2026-01-01T00-00-00-000-abc.json levels
CatQuery: Restore complete: channels_permanent, levels
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.
StinkyCat686: cq-send mychannel Hello, world!
No command response.
sql Superuser
▼
Description
Executes a SQL query against the database.
Usage
cq-sql <SQL statement>
Examples
Select users from the users table.
FartyDragon883: cq-sql SELECT id, username FROM users LIMIT 2
CatQuery: {"rows":2,"results":[{"id":"123456","username":"alice"},{"id":"789012","username":"bob"}]}
uncrossban Superuser
▼
Description
Unban one or more Twitch users across every opted-in moderated channel.
Usage
cq-uncrossban <username[,username2,...]>
Examples
Remove a crossban from all opted-in channels.
PoopyIgloo450: cq-uncrossban troublesome
CatQuery: Uncrossbanned troublesome in 47/50 channel(s). (3 not banned)
Remove crossbans for multiple users.
StinkyCat254: cq-uncrossban bot1,bot2,bot3
CatQuery: Uncrossbanned 3/3 users. Unbans: 141/150. (9 not banned)