All Commands

Complete reference for all Clocky bot commands. All commands use Discord's slash command system - just type / in any channel to see available commands.


User commands

These commands are available to all users in any server with Clocky installed.

/checkin

Start tracking your work time for the current server.

/checkin
  • Name
    Description
    Description

    Begins a new work session and starts the timer. You can only be checked in to one server at a time.

  • Name
    Cooldown
    Description

    5 seconds

  • Name
    Notes
    Description
    • If already checked in to another server, you'll be prompted to check out first
    • Sessions automatically close after 12 hours (configurable by admins)
    • Shows confirmation with check-in time

/checkout

Stop tracking time and end your current work session.

/checkout
  • Name
    Description
    Description

    Ends your active work session and displays a summary with total worked time, excluding any break time.

  • Name
    Cooldown
    Description

    5 seconds

  • Name
    Shows
    Description
    • Check-in time
    • Check-out time
    • Total duration
    • Break time (if any)
    • Net worked time

/status

Check your current check-in status.

/status
  • Name
    Description
    Description

    Shows whether you're currently checked in, and if so, for how long. Also displays break status if applicable.

  • Name
    Cooldown
    Description

    5 seconds

  • Name
    Displays
    Description
    • Current status (checked in or not)
    • Check-in time
    • Current duration
    • Break status and duration
    • Server name

/stats

View your work statistics for different time periods.

/stats [range] [user]
  • Name
    Parameters
    Description

    range (optional): Time period - today, week, month, or all-time (default: today)

    user (optional, admin only): View another user's statistics

  • Name
    Cooldown
    Description

    10 seconds

  • Name
    Shows
    Description
    • Total worked time
    • Number of sessions
    • Average session duration
    • Longest session
    • Time breakdown by day (for week/month ranges)
  • Name
    Privacy
    Description

    Your stats are private by default. Only guild admins can view other users' stats.

Examples:

/stats range:today

/leaderboard

View server rankings based on worked time.

/leaderboard [range]
  • Name
    Parameters
    Description

    range (optional): Time period - today, week, month, or all-time (default: week)

  • Name
    Cooldown
    Description

    10 seconds

  • Name
    Shows
    Description
    • Top users by worked time
    • Rank, username, and total hours
    • Your rank if you're opted in
  • Name
    Privacy
    Description

    Only shows users who have opted-in with /public. You're private by default.


/history

View your recent work sessions.

/history [limit]
  • Name
    Parameters
    Description

    limit (optional): Number of sessions to display (1-50, default: 10)

  • Name
    Cooldown
    Description

    10 seconds

  • Name
    Shows
    Description

    For each session:

    • Date and time
    • Duration
    • Server name
    • Break time (if any)

/break

Manage breaks during your work session.

/break <start|end|status>
  • Name
    Subcommands
    Description
    • /break start - Start a break
    • /break end - End your current break
    • /break status - Check break status
  • Name
    Cooldown
    Description

    5 seconds

  • Name
    Notes
    Description
    • Must be checked in to use break commands
    • Break time is tracked separately and excluded from worked time
    • Useful for lunch breaks, meetings, etc.

Examples:

/break start

/public

Opt-in or opt-out of public leaderboards.

/public [visibility:on|off]
  • Name
    Parameters
    Description

    visibility (optional): on or off

    • If not provided, shows your current visibility status
    • on - Appear on public leaderboards
    • off - Make yourself private
  • Name
    Description
    Description

    Control your leaderboard visibility. When enabled, your worked time and rank will be visible to others in the server leaderboard.

  • Name
    Cooldown
    Description

    30 seconds

  • Name
    Default
    Description

    You are private by default. Use /public visibility:on to become visible on leaderboards.

Examples:

/public

Admin commands

These commands require the "Manage Server" permission.

/admin-close-session

Manually close a user's stuck session.

/admin-close-session user:@username
  • Name
    Parameters
    Description

    user (required): The user whose session to close

  • Name
    Permission
    Description

    Requires "Manage Server" permission

  • Name
    Use cases
    Description
    • User forgot to check out
    • Bot was offline when user tried to check out
    • Session stuck due to an error
  • Name
    Notes
    Description
    • Calculates worked time from check-in to now
    • Logs action in audit log
    • Notifies the affected user

/admin-set-autoclose

Configure the auto-close duration for sessions.

/admin-set-autoclose hours:[1-24]
  • Name
    Parameters
    Description

    hours (required): Number of hours before auto-close (1-24)

  • Name
    Permission
    Description

    Requires "Manage Server" permission

  • Name
    Default
    Description

    12 hours

  • Name
    Notes
    Description
    • Applies to all new sessions in the server
    • Existing sessions use the duration set when they started
    • Helps prevent inflated time tracking from forgotten checkouts

/admin-configure-deletion

Configure data deletion policy for the server.

/admin-configure-deletion <subcommand> [parameters]
  • Name
    Subcommands
    Description
    • /admin-configure-deletion view-config - View current deletion configuration
    • /admin-configure-deletion set-policy policy:<choice> - Set deletion policy (immediate/grace_period/requires_approval)
    • /admin-configure-deletion set-grace-period days:<number> - Set grace period (1-365 days)
    • /admin-configure-deletion enable-legal-retention enabled:<boolean> - Enable/disable legal retention
    • /admin-configure-deletion set-retention-years years:<number> - Set legal retention years (1-99)
  • Name
    Permission
    Description

    Requires "Manage Server" permission

  • Name
    Use cases
    Description
    • Configure immediate vs delayed deletion
    • Set up approval requirements
    • Enable legal compliance retention

Examples:

/admin-configure-deletion view-config

/admin-review-deletion-requests

Review and approve pending deletion requests (requires_approval mode only).

/admin-review-deletion-requests <subcommand> [parameters]
  • Name
    Subcommands
    Description
    • /admin-review-deletion-requests list - List all pending deletion requests
    • /admin-review-deletion-requests review request-id:<number> - Review specific deletion request
  • Name
    Permission
    Description

    Requires "Manage Server" permission

  • Name
    Shows
    Description
    • List of users with pending deletion requests
    • Request date
    • Data to be deleted
    • Approve/deny buttons
  • Name
    Notes
    Description

    Only available when server uses "requires_approval" deletion policy

Examples:

/admin-review-deletion-requests list

/rate-limit-stats

View rate limiting statistics for the server.

/rate-limit-stats
  • Name
    Permission
    Description

    Requires "Manage Server" permission

  • Name
    Shows
    Description
    • Commands per minute
    • Rate limit status
    • Throttled requests
    • Per-user statistics
    • Circuit breaker status
  • Name
    Use cases
    Description
    • Monitor server load
    • Identify users hitting rate limits
    • Debug performance issues

Premium commands

Available to servers with Premium, Pro, or Lifetime subscription.

/billing

View current subscription status and billing information.

/billing
  • Name
    Permission
    Description

    Requires "Manage Server" permission (or any user in Premium/Pro/Lifetime servers)

  • Name
    Shows
    Description
    • Current tier (Free/Premium/Pro/Lifetime)
    • User limits
    • Data retention period
    • Features available
    • Expiration date (if applicable)

/subscribe

Manage premium subscription for the server.

/subscribe
  • Name
    Permission
    Description

    Requires "Manage Server" permission

  • Name
    Action
    Description

    Opens Discord's native subscription flow for Premium Apps. Allows you to:

    • Subscribe to Premium, Pro, or Lifetime
    • Upgrade existing subscription
    • View payment history
    • Manage billing details

/usage

View detailed usage statistics (Premium/Pro/Lifetime only).

/usage
  • Name
    Permission
    Description

    Requires "Manage Server" permission

  • Name
    Shows
    Description
    • Active users this month
    • Total commands executed
    • Data storage used
    • API call statistics
    • Rate limit headroom
  • Name
    Availability
    Description

    Premium, Pro, and Lifetime tiers only


GDPR & Privacy commands

Commands for managing your personal data in compliance with GDPR regulations.

/data-export

Export all your personal data (GDPR Article 15 - Right to Access).

/data-export
  • Name
    Description
    Description

    Generates a complete export of all your personal data in machine-readable JSON format.

  • Name
    Cooldown
    Description

    24 hours

  • Name
    Includes
    Description
    • User profile information
    • All work sessions across all servers
    • All break sessions
    • Statistics and metadata
    • Leaderboard preferences
  • Name
    Delivery
    Description

    Sent as a DM with a JSON file attachment. Data is encrypted and expires after 24 hours.


/data-delete

Permanently delete your personal data (GDPR Article 17 - Right to Erasure).

/data-delete <current-server|all-servers>
  • Name
    Subcommands
    Description
    • /data-delete current-server - Delete your data from THIS server only
    • /data-delete all-servers - Delete your data from ALL servers permanently
  • Name
    Cooldown
    Description

    None (one-time action)

  • Name
    Confirmation
    Description

    Requires button confirmation to prevent accidental deletion

  • Name
    Deletes
    Description
    • User profile
    • All work sessions
    • All break sessions
    • All statistics
    • All preferences
  • Name
    Notes
    Description
    • This action cannot be undone
    • Takes effect immediately (or pending admin review in soft delete mode)
    • Logged in audit log for compliance
    • Does not delete Discord account or server membership
    • Choose scope carefully: current-server vs all-servers

Examples:

/data-delete current-server

/privacy

View Clocky's privacy policy.

/privacy
  • Name
    Description
    Description

    Displays a link to the complete privacy policy with information about data collection, usage, and retention.

  • Name
    Cooldown
    Description

    None


/terms

View Clocky's terms of service.

/terms
  • Name
    Description
    Description

    Displays a link to the complete terms of service.

  • Name
    Cooldown
    Description

    None


Command cooldowns

To prevent abuse, commands have cooldowns:

CommandCooldownReason
/checkin, /checkout, /status, /break5 secondsPrevent spam
/stats, /leaderboard, /history10 secondsDatabase queries
/public30 secondsPrevent toggle spam
/data-export24 hoursGDPR compliance, prevent abuse
Admin commands5-10 secondsModerate usage

Rate limits

In addition to per-command cooldowns, guild-level rate limits apply:

TierCommands per minute
Free60
Premium120
Pro180
Lifetime300

Administrators with "Manage Server" permission bypass rate limits.


Need help with a command?

Was this page helpful?