Introduction

What is Mellow?

Mellow is an AI-powered mental health companion for Discord communities. It provides gentle, private, supportive conversation, mood tracking, coping tools, and crisis screening, with a personality and tone that adapt to your preferences and time of day.

Mellow runs with no privileged Discord intents. It only sees message content in DMs and in messages that mention or reply to it, plus text you explicitly hand it through a command or the "Check on this message" context menu.

Quick start

1. Invite Mellow to your server, or add it as a user app for DMs.
2. Set your preferences with /preferences set (timezone matters for late-night mode).
3. Do your first check-in with /checkin.
4. Explore coping tools with /coping.
5. Configure your server with /guildsettings set (admins).

Quick links

• Get started - setup guide and first steps
• Features overview - all capabilities and tools
• Commands reference - every command documented
• Privacy controls - data and privacy management
• Join the support server - community help and discussion
• View the source - open-source repository

Key features

AI support

• Conversation memory - Mellow can remember context from previous conversations, if you allow it.
• Personality customization - six styles: gentle, supportive, direct, playful, professional, encouraging.
• Time-aware responses - tone adapts to your timezone and the time of day.
• Crisis screening - AI analysis of text you share, with a graded response and resources.

Mental health tracking

• Mood check-ins - a wide range of moods, plus an intensity rating (1-5), activity, and a note.
• Insights - trends and summaries from your check-in history.
• Reminders - optional, timezone-aware check-in reminders.

Coping toolkit

• Guided exercises - breathing, grounding, affirmations, challenges, distraction, music.
• Personalized toolbox - save favourite tools and track usage streaks.
• Coping plans - keep a personal plan you can view or update at any time.
• Journalling and gratitude - private entries, encrypted at rest.

Late-night companion mode

• Automatic - based on your timezone.
• Gentler support - calmer responses during difficult late hours, encouragement in the morning.

Private expression

• Ghost letters - write an unsent letter to get feelings out; only you can read them.
• Full data control - export or delete your data at any time with /preferences and /context.

Privacy and safety controls

• Per-user settings - control what Mellow remembers and whether crisis detection runs on your messages.
• Per-guild settings - admins configure features, channels, and a moderator role.
• Transparency - /context view shows what is stored.
• Encryption - sensitive fields are encrypted per-field with AES-256-GCM.

Important notice

Mellow is not a replacement for professional mental health care.

• It is not for diagnosis or treatment of mental health conditions.
• Emergency situations require immediate professional intervention.
• Always consult qualified mental health professionals for serious concerns.

Getting help

• Documentation: browse these docs for detailed information.
• Discord support: join our support server.
• GitHub issues: report bugs or request features.
• Contact: [email protected].