Documentation menu

Documentation

Everything Lucy can do, from the first /start to guild federations: setup, features, commands, and settings.

Lucy starts watching the moment she joins a group and 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 visual human checks for new members, with mute holds and quarantine on failure.
  • 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.

Reference

  • Commands reference — Every public Lucy command grouped by who can use it and what it does.
  • Settings reference — All /settings fields with allowed values, defaults, and guild sync categories.