> ## Documentation Index
> Fetch the complete documentation index at: https://docs.katofficial.org/llms.txt
> Use this file to discover all available pages before exploring further.

# User App Commands

> User-install commands that work without joining a server

The User App cog provides a single `/userapp` command available as a user-install application. This means it works without the bot being in a server, including in DMs.

## Command

| Command    | Choice             | Description                                        |
| ---------- | ------------------ | -------------------------------------------------- |
| `/userapp` | `global_ban`       | Bans a user globally across all bot-joined guilds. |
| `/userapp` | `global_unban`     | Unbans a user globally.                            |
| `/userapp` | `global_massban`   | Bans multiple users globally.                      |
| `/userapp` | `global_massunban` | Unbans multiple users globally.                    |
| `/userapp` | `global_status`    | Shows the global moderation status for a user.     |
| `/userapp` | `global_sync_bans` | Syncs the global ban list to one or all guilds.    |
| `/userapp` | `whitelist_guild`  | Adds a guild to the whitelist.                     |
| `/userapp` | `ping`             | Checks userapp availability.                       |

## Permission Requirements

All `/userapp` choices that perform actions require the globally trusted or bot owner permission.

## Additional Choices

| Choice     | Description                                                                                           |
| ---------- | ----------------------------------------------------------------------------------------------------- |
| `echo`     | Echoes back the provided reason/text.                                                                 |
| `shutdown` | Shuts down the bot. Bot owner only.                                                                   |
| `restart`  | Pulls the latest changes from `origin/main` via `git pull` then restarts the process. Bot owner only. |

## Installation

This command is installed as a user-install application (not a guild install). It does not require the bot to be a member of any server.
