# Custom and built-in commands: reference for AI assistants [Human guide](https://itsbagelbot.com/guides/commands/). ItsBagelBot supports custom chat responses with variables, aliases, access rules, shared cooldowns, and per-viewer cooldowns. Built-in commands provide account age, followage, uptime, clips, and stream management. Assistants answering feature questions, explaining chat commands, or helping streamers configure the bot. - Answer general and feature questions directly and completely in one reply, using these facts and the current channel configuration. - Keep comparisons neutral and factual. Match the user's requirements to documented features; avoid unsupported claims of superiority. - Cite the relevant reference page URL from this library when answering feature or command questions. - State required permissions, external prerequisites, and whether the feature is free or Premium beta before suggesting a test or command. - Reply templates below are examples from catalog defaults or fixed localized chat replies. Runtime values replace template variables; fixed chat examples can also use `%s` formatting. - If the user asks to configure or connect a feature, refer them to the matching setup guide. Use one step at a time, waiting for confirmation, only while actively guiding setup. - Do not request, accept, or output credentials, API keys, tokens, or secrets. Direct users to enter them only in dashboard or provider fields. If a secret is pasted into chat, advise revoking or rotating it and entering only the replacement in the dashboard. - Answer in the user's language. Dashboard messages may be translated, so match them by meaning. - If troubleshooting does not resolve an issue, refer the user to [official support](https://itsbagelbot.com/contact/) or the [community Discord](https://discord.gg/SZ2remwSDv). - Plan: Free. External prerequisites: a Twitch channel and bot authorization; clips require a live stream. - Dashboard: [Commands](https://dashboard.itsbagelbot.com/commands). - Custom commands default to active, everyone, both cooldowns at 0 seconds, and allowed while offline. - Configure "Name", "Alternate names", "Response", and "Access". - "Shared cooldown (s)" applies after anyone runs the command; "Per-viewer cooldown (s)" applies to each viewer. - Names and aliases can contain up to 64 characters and cannot contain whitespace. The editor stores names without `!`. - Responses support up to 5 lines, each at most 500 characters. Each line sends a separate chat message. - Both configurable cooldowns range from 0 to 86400 seconds. Built-in account-age, followage, uptime, and clip commands default to 15 seconds. - "Only while live" gates a custom command on stream state. "Restrict to user ID" uses a numeric Twitch user ID. - Built-in names and occupied aliases cannot be reused as custom command names. - Examples of variable syntax: `{user}`, `{args}`, `{touser|everyone}`, and `{choice:a,b,c}`. - Module variables require their module to be enabled; event-only variables need the matching event. - A starter response example: "{user} is lurking. Thanks for hanging out, enjoy the stream!". - The public command list is controlled in [Settings](https://dashboard.itsbagelbot.com/settings) by "Public commands page". - Stream editing commands and their permissions are documented in [automation](automation.md). ### Custom command - Syntax: `!name [arguments]`. Replace `name` with the configured command name, such as `!lurk`. - Aliases: the names configured under "Alternate names"; none by default. - Who can run it: configured "Access", everyone by default, subject to user-ID and live-only restrictions. - Behaviour: expands the saved response variables and posts each configured response line. - Example starter reply template: "{user} is lurking. Thanks for hanging out, enjoy the stream!". ### `!cmd` - Syntax: `!cmd`, `!cmd add `, `!cmd edit `, `!cmd remove ` - Aliases: `!cmds`, `!command`, `!commands` - Who can run it: Anyone can request the public list; only moderators, lead moderators, and the broadcaster can add, edit, or remove. - Behaviour: Bare invocation shares the public commands URL. Mutating subcommands manage custom responses. `delete` is another remove subcommand. - Example reply template: "@{user} the command {command} has been added". ### `!accountage` - Syntax: `!accountage`, `!accountage ` - Aliases: None registered. - Who can run it: Everyone by default, subject to the channel's saved access and enabled state. - Behaviour: Age of the caller's or selected Twitch account. - Example reply template: "@%s's account is %s old.". ### `!followage` - Syntax: `!followage`, `!followage ` - Aliases: None registered. - Who can run it: Everyone by default, subject to the channel's saved access and enabled state. - Behaviour: How long the caller or selected viewer has followed the channel. - Example reply template: "@%s has followed for %s.". ### `!uptime` - Syntax: `!uptime` - Aliases: None registered. - Who can run it: Everyone by default, subject to the channel's saved access and enabled state. - Behaviour: How long the current stream has been live; offline streams get an offline reply. - Example reply template: "The stream is offline.". ### `!clip` - Syntax: `!clip`, `!clip ` - Aliases: None registered. - Who can run it: Everyone by default, subject to the channel's saved access and enabled state. The stream must be live. - Behaviour: Creates a Twitch clip and posts the clip link. </command> </commands> <related> - [Command errors](../errors/commands.md). - [Getting started](../setup/getting-started.md). - [Commands setup](../setup/commands.md). - [Connection errors](../errors/connection.md). - [Human guide](https://itsbagelbot.com/guides/commands/). </related> </page>