Command Reference

CLNR Commands List

Explore all 194 invokable commands. Use the filters or search bar to find exactly what you need, then open each command for concrete usage guidance.

1. Initial Setup Essentials

/start Begin Guided or Quick setup; Quick checks required roles before applying its preset. Guided also reviews saved setup settings.
/config show Show server settings with inline toggles, setup shortcuts, and section navigation.
/config share Generate a shareable CLNR configuration summary for this guild.
/config validate Validate setup and open private staff-channel repair when needed.
/config check_permissions Check channel permissions and CLNR's role position for configured actions.
/config set admin_role Set an existing admin-command role; CLNR does not need Manage Roles or a higher role position.
/config remove admin_role Clear the configured admin role for this guild.
/config set staff_notification_channel Set the channel for staff notifications.
/config set amnesty_window Pause decay increases until a date.
/config set decay_increment Set how much decay score increases per interval.
/config set decay_interval Set how often decay score increments (in days).
/config set decay_role_threshold Set decay score for assigning inactive role.
/config set inactive_role Set the role to apply to inactive members.
/config set inactivity_role_mode Choose how roles are handled when members become inactive.
/config set kick_threshold Set decay score for kick eligibility.
/config set language Set the bot's language for this guild.
/config set operating_mode Switch between Standard and Ghost operating modes; returning from Ghost can offer a guarded one-time re-engagement notice.
/config set warning_threshold Set decay score for warning members.
/help Get help with CLNR, view commands, or report an issue.

Access: public

Direct link

2. Setup Tuning

/config add decay_boost_role Add role to slow down decay for its members.
/config add default_role Add a restore/swap role.
/config add exempt_role Add an inactivity-exempt role; CLNR does not need Manage Roles or a higher role position.
/config add kick_exemption Add a member to the individual kick exemption list.
/config add whitelisted_category Add categories to the list of categories the bot should NOT scan for activity.
/config add whitelisted_channel Add channels to the list of channels the bot should NOT scan for activity.
/config clear default_roles Clear all restore/swap roles, allowing a reset if roles were deleted.
/config clear exempt_roles Clear all exempt roles.
/config clear kick_announcement_channel Clear the dedicated kick summary announcement channel.
/config clear whitelisted_categories Clear all categories from the whitelist, allowing activity scanning in all categories.
/config clear whitelisted_channels Clear all channels from the whitelist, allowing activity scanning in all text channels.
/removal config Choose removal staff and one or two approvers for requests and manual inactivity reviews.
/removal off Immediately stop removal requests, approvals, execution, and delegated inactivity confirmations.
/pulse setup Configure Pulse theme, channel, public posts, and nudges.

Access: admin

Direct link

/config remove decay_boost_role Remove role that slows down decay for its members.
/config remove default_role Remove a restore/swap role.
/config remove exempt_role Remove an inactivity-exempt role.
/config remove inactive_role Remove the inactive role config and reset Ghost mode inactive-role mode.
/config remove amnesty_window Remove amnesty window.
/config remove auto_kick_daily_limit Remove Auto-Kick compatibility cap.
/config list kick_exemptions List members who are individually exempt from kicks, with an option to remove exemptions.
/config remove kick_exemption Remove a member's individual kick exemption and reset their decay score and streak to zero.
/config remove manual_kick_review_channel Reset the manual kick review channel (staff channel fallback remains).
/removal status Check removal approval readiness, destination, role, and permissions.
/removal request Guide staff through a kick or ban request requiring one or two other approvers, according to settings.

Access: removal staff or admin

Direct link Staff Removal Approval

/removal list Find open staff removal requests and their approval cards.
/config remove reinvite_url Remove the configured reinvite URL from pre-kick DMs.
/config remove whitelisted_category Remove categories from the list of categories the bot should NOT scan for activity.
/config remove whitelisted_channel Remove channels from the list of channels the bot should NOT scan for activity.
/config set decay_reduction Set decay reduction on activity.
/config set auto_kick_daily_limit Set Auto-Kick compatibility cap.
/config set kick_announcement_channel Set the channel for kick summary announcements.
/config set manual_kick_channel Set channel, where for manual kick reviews should be posted to.
/config set reinvite_url Set the reinvite URL included in pre-kick DMs.
/config set manual_kick_review_channel Set the manual kick review channel (alias of manual_kick_channel).
/config set seriousness_loyals Set seriousness loyal-member days.
/config set seriousness_newbies Set seriousness new-member days.
/config set seriousness_percent Set decay seriousness percent.
/config set warning_channel Set the channel where warnings are sent to inactive members.
/toggle auto_kick Toggle automatic kicking of kick-eligible members.
/toggle auto_provision_assets Automatically create missing preset channels and roles when available.
/toggle dead_channels_report Toggle monthly dead-channel reports.
/toggle decay_reset Toggle if decay score resets to 0 on activity or not.
/toggle dm_inactive Save inactive DM preferences; previews explain the Ghost Mode delivery block.
/toggle dm_kick Save pre-kick DM preferences; previews explain the Ghost Mode delivery block.
/config inactivity_notifications Toggle inactivity channel notices; turning off requires Standard Mode and both threshold DMs.
/toggle dm_warning Save warning DM preferences; previews explain the Ghost Mode delivery block.
/toggle ghost_member_posts Disable Ghost mode member-related posts while keeping tracking and cleanup active.
/toggle kick_announcements Toggle kick summary announcements in warning/staff channels.
/toggle monthly_summary Toggle monthly staff summaries.
/toggle notification_threads Toggle warning comment threads.
/toggle why_buttons Toggle announcement Why buttons.
/toggle warning_channel_staff_only Route warning announcements to the staff channel instead of the public warning channel.

3. Activity Sources + CTA

/toggle cta_button Toggle the I'm Active CTA button.
/toggle emoji_add_activity Set if new emoji additions count as activity.
/toggle interactions_activity Set if commands and component interactions count as activity.
/toggle member_join_activity Set if member joins count as activity.
/toggle message_pin_activity Set if message pins count as activity.
/toggle reactions_as_activity Set if reactions should count as activity.
/toggle scheduled_events_activity Set if scheduled event RSVPs count as activity.
/toggle thread_activity Set if thread creation and joins count as activity.
/toggle typing_activity Count typing indicators as activity; messages count automatically.
/toggle voice_activity Set if voice and stage participation counts as activity.

4. Reporting + Insights

/monthly_report Privately preview the last completed month: Free overview with a direct Brief preview, or a full report with Premium. Shows effective capacity or unavailable status. No staff post or credit spent.
/review brief Concise private Staff Meeting Brief with detailed reviews in a Markdown download; also available from the Staff Review selector. Free admins preview coverage and available observations first.

Access: admin, premium

Direct link Premium Staff Reviews

/review impact Monthly or period-based Premium Staff Review.

Access: admin, premium

Direct link Premium Staff Reviews

/review cleanup Cleanup workload, fairness context, recoveries, and next staff action.

Access: admin, premium

Direct link Premium Staff Reviews

/review channels Review up to five quiet channels for discussion, the total quiet count, confidence, and staff questions.

Access: admin, premium

Direct link Premium Staff Reviews

/review coverage Coverage Confidence Review with affected claims and next steps.

Access: admin, premium

Direct link Premium Staff Reviews

/review retention Retention review for tracked members known to CLNR.

Access: admin, premium

Direct link Premium Staff Reviews

/review engagement Short-window engagement review with confidence and recommendations.

Access: admin, premium

Direct link Premium Staff Reviews

/review history Rolling saved Staff Review history with saved engagement, coverage, and channel trend context.

Access: admin, premium

Direct link Premium Staff Reviews

/config reports weekly_inactivity Toggle the default-off Monday clean inactivity report in the staff channel.
/report_inactivity [Admin] Generate an inactivity report for this guild.

Access: admin

Direct link

/scan_history [Admin] Manually scans message history for member activity.
/coverage Show seeding coverage: tracked members vs. estimated server total.

Access: admin

Direct link

/checkin wizard [Admin] Open the server check-in wizard.
/checkin policy_schedule_toggle Enable or disable scheduled policy check-ins.
/icebreaker config Configure Icebreakers and quiet hours with city-name timezone search, plus an optional role ping.
/icebreaker status Check Icebreaker readiness and the latest channel message.
/icebreaker preview Privately preview an Icebreaker at the saved question level.
/icebreaker post Preview and confirm an Icebreaker post to the configured channel.
/casefile start Start a Community Casefile in a community channel with optional theme packs.
/casefile status Show the current or recent Casefile status, outcome, schedule, and theme-pack library.
/casefile channels Set which channels can wake ready Casefile progress.
/casefile schedule Set Casefile start mode, pacing, and allowed theme packs.
/casefile resume Publish a ready Casefile stage now.
/casefile recover Repost the current Casefile Stage Card.
/casefile stop Stop the active Community Casefile.
/border-challenge start Start a cooperative flag-reaction country-border chain.
/border-challenge restart [Admin] Restart the active Border Challenge with a fresh country.
/border-challenge stop [Admin] Stop the active Border Challenge.
/border-challenge collection Show a member's Border Challenge collection.
/border-challenge missing Show a member's missing Border Challenge countries.
/decay_top10 Shows members with the highest or lowest decay scores.

Access: public

Direct link

/user_score [Admin] Shows the decay and activity score, and history for a specific user.
/pulse view Preview this server's activity scene and staff details.

Access: admin

Direct link

/score Show this server's Activity Health Score and trend preview.
/score_publish Publish the latest Activity Health Score to a channel.
/score_settings Inspect or adjust Activity Health Score settings.

5. Premium + Growth

/premium Learn about CLNR's premium features and how to unlock them!

Access: admin

Direct link

/checkpremium Check access, trial status, and the current tracked-member limit.
/guildtiers View the member limits for each tier.

Access: admin

Direct link

/vote Show your vote status and this community's progress.
/bulk_user_upload [Admin] Import members from IDs or CSV; open the ID form when no input is provided.
/export_decay_data [Admin] Exports stored member activity as CSV with current admin and Premium access. Free previews show columns and coverage. Explains unavailable access, size limits or timeouts without sending partial files.

Access: admin, premium

Direct link

6. User Commands

/my_score Shows your current scores, activity calendar, and recent history.
/notifications Manage your personal CLNR DM reminders for this server.

Access: public

Direct link

/thanks Let someone know their effort here matters, quietly.
/mute Mute inactivity reminders from CLNR for this server.

Access: public

Direct link

/unmute Unmute inactivity reminders from CLNR for this server.

Access: public

Direct link

7. Activity Streaks

/toggle activity_streaks Toggle notifications for activity streak achievements.
/toggle weekly_leaderboard Toggle the default-on Monday leaderboard post in the warning channel.
/leaderboard Shows the activity streak leaderboard.
/config set min_streak_notification Set the minimum streak for a highscore notification.
/monthly_champions Shows the monthly activity champions for this server.

8. Reward Roles

/reward_roles_wizard Configure Activity Reward Roles; current access, Manage Roles and target roles are rechecked before saving.
/reward activity_rewards Toggle the activity reward role system on or off.
/reward reward_role_announcements Toggle public reward role announcements without disabling rewards.
/reward reward_grace_dm Save reward grace DM preferences; previews explain the Ghost Mode delivery block.
/reward streak_grace_period Sets the grace period for activity streaks (in intervals).
/reward add_role Adds a role for activity rewards.
/reward remove_role Removes a role from activity rewards.
/reward clear_roles Clears all activity reward roles.
/reward_members Lists members with activity reward roles (highest to lowest).

9. Polls

/polls_wizard Configure Polls, Quizzes, scheduled Check-Ins, and quick polls.
/polls toggle Enable or disable polls.
/polls send_now Post a poll immediately (bypasses timing checks).
/polls channel Set the channel to post polls (falls back to warning channel if unset).
/polls checkins_channel Set the channel for scheduled community check-ins.
/polls checkins_toggle Enable or disable scheduled community check-ins.
/polls checkins_cadence Set how often scheduled check-ins post (in days).
/polls checkins_topics Choose scheduled community check-in topics.
/polls frequency Set how often to post polls (in days).
/polls frequency_intervals Set poll interval in decay intervals (takes precedence over days).
/polls no_repeat_window Set the no-repeat window for polls (number of previously used polls to avoid).
/polls tags_mode Set how tag filtering works for polls ('any' or 'all').
/polls add_tag Add a tag to filter polls by.
/polls remove_tag Remove a tag from polls filter.
/polls clear_tags Clear all tags used to filter polls.
/polls clear_recent Reset recent polls history (no-repeat list).
/polls delete_previous Delete the previous poll message before posting a new one.

10. Additional Features + Admin Utilities

/advises opt_in Receive staff advisories via DM.
/advises opt_out Stop receiving DM copies of advisories.
/advises show Show the current staff advisory status.
/advises send Send a specific staff advisory immediately.
/advises snooze Pause advisories for a number of days.
/advises toggle action_suggestions Enable or disable Premium staff action suggestions.
/advises toggle delivery Pause or resume advisories while preserving topic progress.
/advises toggle staff_channel Mute or resume staff-channel advisory posts.
/advises toggle training_mode Toggle training guidance without resetting advisory topic progress.
/config history Show recent config and auto-kick history.
/next_check Shows when the next decay calculation cycle will run.

Access: public

Direct link

/set_decay_score [Admin] Set a human member's decay score (0-180).

Access: admin

Direct link

/reset_member_activity [Admin] Reset one member's CLNR activity and decay data.

Access: admin

Direct link

/reset_all_decay_scores [Admin] Resets all decay scores to zero for the current guild.

Access: admin

Direct link

/purge_channel [Admin] Deletes messages in a channel, optionally limited to one member or user ID. Must be run from a different channel.

Access: admin

Direct link

/tips_reset [Admin] Clears tip frequency caps and 'never' settings for this guild.

Access: admin

Direct link

11. General Info + Status

/about Learn what CLNR does and find key links.

Access: public

Direct link

/changelog Lists CLNR updates, with a labelled saved copy if the website cannot be refreshed.

Access: public

Direct link

/donate Support CLNR with a voluntary donation.

Access: public

Direct link

/feedback Share feedback about CLNR - good or bad, all input helps.

Access: public

Direct link

/invite Add CLNR to another server or join the support community.

Access: public

Direct link

/ping Check CLNR's current status, latency, and system health.

Access: public

Direct link

/terms Displays the Terms of Service and Privacy Policy for CLNR.

Access: public

Direct link

/config status channels Show key bot channel settings and quick permission hints.
/config status inactivity Show inactivity/decay mechanism settings.
/config status polls Show polls and check-ins configuration and status.
/config status polls-checkins Show polls and check-ins configuration and status.
/config status rewards Show activity rewards settings.
/config status roles Show core role settings.
/config status score Show Activity Health Score configuration and status.
/config status streaks Show activity streaks settings.

Need help?

Join the community for command-level questions, or open the use case guides to pick a tested setup baseline.