Skip to main content

Overview

Annie Mei includes two utility slash commands to help you get started and confirm bot health:
  • /help - Shows a command guide and usage tips
  • /ping - Verifies the bot is online and responding

/help command

Command syntax

/help
No parameters are required.

Response data

The /help command returns an embed with:
Title
Personalized greeting with your Discord username
Description
Overview of what the bot can do:
  • Anime and manga detail lookups
  • Theme song searches
  • AniList account linking and guild watch/read visibility
Getting started
  1. Run /register and click the AniList link button
  2. Finish authorization in your browser
  3. Use /anime or /manga to search media
  4. Use /songs for opening and ending tracks
  5. Use /whoami to confirm the linked profile
Commands
Complete slash command list:
  • /anime search:<term or id>
  • /manga search:<term or id>
  • /songs search:<term or id>
  • /register (secure OAuth link flow)
  • /whoami (shows linked AniList account)
  • /ping
  • /help
Tips
  • Search with names, aliases, or AniList IDs
  • Use exact IDs for fastest lookups
  • Run /whoami if member status is not showing as expected

Example usage

/help
The bot posts the full command reference in the current channel.

Source code reference

Implementation: src/commands/help.rs:13 help() defines the slash command metadata and run() builds the embed response.

/whoami command

Command syntax

/whoami
No parameters are required.

Response messages

Linked account
Your linked AniList account is **AnimeName**.
Profile: <https://anilist.co/user/AnimeName>
Returns the AniList username and profile URL currently stored in your account link.
Not linked yet
You have not linked an AniList account yet. Run `/register` first.
Use /register to start the OAuth flow.

Example usage

/whoami
The bot returns your link status in a private ephemeral response.

Source code reference

Implementation: src/commands/whoami.rs:29 whoami() defines the slash command and handle_whoami() formats the user-facing output.

/ping command

Command syntax

/ping
No parameters are required.

Response message

The /ping command returns:
Hello @YourUsername! I'm Annie Mei, a bot that helps you find anime and manga!

Use cases

Health check

Verify the bot is online and responding

Test permissions

Confirm bot can read and send messages in the channel

Fast feedback

Confirm interaction routing is working

Introduction

See the bot’s name and feature summary

Source code reference

Implementation: src/commands/ping.rs:11 ping() defines the slash command and run() sends a simple greeting response.

When to use each command

ScenarioCommandWhy
You need a command cheat sheet/helpOpens the full command list
You are not sure if /anime will work/helpConfirms available features
Bot feels unresponsive/pingQuick health check
You want to confirm linked account/whoamiShows linked AniList username
You need to link again/registerRestarts OAuth linking
If /help or /ping fails, check the bot is online and has message permissions in the channel.

Troubleshooting

Possible causes
  • The bot is temporarily unable to attach mei.jpg
  • Discord embed rendering is delayed
Fix
  • Retry the command
  • Verify the bot files are intact on its host
Possible causes
  • Registration flow has not completed
  • OAuth flow was interrupted before callback finished
Fix
  • Run /register and complete the browser flow in one session
  • Ask your bot administrator to verify AUTH_SERVICE_BASE_URL and OAUTH_CONTEXT_SIGNING_SECRET
This is usually caused by a client-side interaction display issue. If it continues, restart the bot and check for updates.