Skip to content

whykusanagi/celeste_bot_docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 

Repository files navigation

Celeste Bot — Public Command Catalog & Install Guide

Celeste AI Badge Compliance Badge Commands Badge

Celeste is a public Discord application that blends playful conversation, anime intelligence, and union raid automation. This page is written for server owners and community members who want to understand what she does and how to use her safely.

✅ Celeste follows the enterprise-grade documentation and transparency standards defined in CLAUDE.md. Everything below focuses on consumer-facing guidance—no secrets, no internal implementation details.

Celeste AI Discord Bot


Invite Celeste

Add Celeste to your server

Before inviting, confirm you have the Manage Server permission, then grant the default scope (bot applications.commands). Celeste does not require dangerous permissions; moderation actions stay limited to the commands you run.


Quick Start

  1. Invite using the link above and choose the server from the selector.
  2. Assign channels/roles Celeste should interact with (e.g., raids, NSFW verification, daily quote channel).
  3. Test commands with /help and /ping to confirm connectivity.
  4. Review audit trail (optional) by tailing logs/command_audit.log if you host Celeste yourself. Hosted/public version already monitors health.

Need help? Ping @whyKusanagi via GitHub Issues or open a ticket in the support Discord.


Highlights for Server Owners

🎨 Celeste Experience Pillars

  • AI-first conversations powered by Celeste’s lore-aware /ask command.
  • Anime & VN discovery with AniList, VNDB, illustration pulls, and staff graphs.
  • Union raid copiloting: boss intel, recommended teams, and post templates.
  • Nikke + gacha fun with authentic rates, pity tracking, and leaderboard-ready embeds.
  • Moderation assists: lightweight /verif workflow and proactive NSFW reminders.
  • Observability: commands are logged (timestamp, guild, actor, parameters) for auditability.

Command Catalog

Each slash command returns embeds or modals that explain required inputs. Rate limits follow Discord’s defaults unless noted.

Core & Conversation

Command What it does
/help Lists every command available to your guild, grouped by feature.
/ping Confirms gateway latency; use if Celeste seems sluggish.
/info Shows the current build, shard, and feature toggles.
/invite Returns the official invite link so members can add Celeste elsewhere.
/ask question:<text> Chat directly with Celeste; she responds in-character with lore-aware answers. Optional advanced parameters (style, spoiler flags) show up contextually in Discord.

Anime, VN, and Media Discovery

Command Purpose
/anilist title:<anime or manga> Fetches AniList details, ratings, airing status, and watch links.
/vndb title:<visual novel> Pulls VNDB synopsis, tags, and heroine breakdowns.
/staffsearch name:<person> Looks up voice actors and staff credits across languages.
/staffgraph name:<person> Generates a relationship map of characters voiced or shows staffed.
/illustration Drops a curated Celeste illustration with playful commentary.
/waifurate attachment/link Rates an image with Celeste’s comedic critique (ephemeral by default).

Recommendations & Personalization

Command Purpose
/recommend_terms tags:<list> Returns anime suggestions based on your selected vibes, genres, or tropes.
/recommend_title title:<existing show> Generates “if you liked X, try Y” recs.
/recommend_semantic prompt:<free text> Uses semantic search to match mood or themes.

Streaming, News & Analytics

Command Purpose
/streamprep Summarizes trending gaming stories with Celeste’s drama ranking—great for pre-stream banter.
/steamcharts game:<title> Live player counts, historical deltas, and peak concurrency from SteamCharts.

Nikke / Gacha Playground

Command Purpose
/pull Single gacha pull with rarity animation.
/multi Ten-pull with pity tracking and summary embeds.
/degenlevel Light-hearted fun score based on recent gacha luck.

Union Raid & Competitive Support

Command Purpose
/union_boss_posts boss:<name> Provides ready-to-post strategy blurbs per boss.
/boss_recommendations difficulty:<tier> Suggests squads and modifiers.
/boss_specific_recommendations boss:<name> Deep dive on one boss’ weaknesses and best comps.
/list_bosses Shows the current rotation with quick notes.
/ur_health, /ur_recommend, /ur_weaknesses, /ur_units Suite of commands pulling Celeste’s curated union raid database for live coaching.

Moderation & Safety (restricted to admins/mods)

Command Purpose
/verif user:<member> Launches Celeste’s NSFW verification flow. You supply a “suspected” role, Celeste handles DMs + logging.
Automation & Observability

Automation & Ambient Flavor

  • LewdQuotes: When enabled, Celeste posts tasteful daily quotes in a channel named daily-lewd-quote.
  • Audit Logging: Every slash command Celeste runs is written to a JSON log for traceability (contains guild, channel, user ID, options, and latency). Hosted version keeps 5 rotating files to satisfy compliance reviews.

Usage Tips & Best Practices

  • Place Celeste in channels where embeds are encouraged; most responses include rich content, buttons, or file attachments.
  • For NSFW commands, confirm the target channel is marked appropriately to comply with Discord policy.
  • Use Discord’s built-in command permissions to gate /verif, raid tools, or anything that pings external APIs.
  • If Celeste stops responding, verify she is online, then rerun /ping. If > 250 ms, consider re-inviting or contacting support with timestamps.

Troubleshooting & Support

Symptom Action
“Interaction failed” toast Another Celeste instance may have already answered. Retry in 2s or check server duplicates.
Command missing Run /help and ensure the command is enabled for your guild. New commands may take up to 1 minute to propagate.
Slow responses Use /ping; if healthy, Discord API latency may be the cause. Try again or file an issue.
Need audit proof Download command_audit.log from your host or request the hosted log excerpt via support ticket.

Contact

  • GitHub Issues: whykusanagi/celeste_bot_docs
  • Deployment/ops escalations: open a ticket in the official Celeste Discord (link provided after install).

Contributing & Licensing

Celeste Bot and this documentation are released under the MIT License. Feel free to fork, improve explanations, or add localized instructions. Please keep references to Celeste’s lore and safety rules consistent with the upstream CLAUDE.md.


Ready to bring Celeste to your community?

Install Celeste on Discord

Once she lands, /help will surface future feature drops automatically. Have fun! 💜

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors