Documentation
Everything Lucy can do, from the first /start to guilds: setup, features, commands, and settings.
On this page
Lucy starts watching a group the moment she joins, and she only acts on what you switch on. These pages cover setup, every feature, and the full command and settings reference.
Start here
- Getting started Add Lucy to your group, grant the rights she needs, and run the readiness check.
- How Lucy thinks The principles behind Lucy's detection, quarantine, and reputation design.
Features
- Bot detection How Lucy scores joins, messages, and reactions, and what allow, watch, and quarantine mean.
- CAPTCHA Optional picture puzzles for new members. Choose the puzzles, set the time limit, and see how a member who failed engaged.
- Greetings Welcome and goodbye messages, templates, visibility, auto-delete, and CAPTCHA gating.
- Message formatting Safe Markdown, fillings, and URL buttons for welcome and goodbye templates.
- Quarantine and verdicts What quarantine does, where evidence cards go, and how Ban, Release, Watch, and Unban work.
- Reports Member /report flow, admin card actions, and report destination settings.
- Moderation commands Admin warn, mute, ban, stealth ban, promote, and demote commands and escalation rules.
- Admin chat Bind a private admin group for quarantine evidence and optional report cards.
- Guilds Federate groups with membership, ban feeds, guild hall, settings sync, and roster commands.
- Dashboard Telegram mini app inbox for pending quarantines and a read-only guild panel.
- Status and reputation Standing cards, reputation bands, human-only events, sharing, and privacy.
- Manage groups from AI tools Connect Claude Code, Codex, Claude, or Cursor to Lucy over MCP. Configure a Premium group, build reports, and triage quarantines by talking to an agent.