User Commands

Complete reference for all user commands available in Clocky. These commands are accessible to all users in any server with Clocky installed.

/checkin

Start tracking your work time for the current server.

/checkin

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

Cooldown: 5 seconds

Notes:

  • 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

Example response:

✅ Checked in at 9:00 AM
Your work session has started!

See Check-in System for detailed documentation.

/checkout

Stop tracking time and end your current work session.

/checkout

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

Cooldown: 5 seconds

Shows:

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

Example response:

✅ Checked out at 5:00 PM

📊 Session Summary
Check-in: 9:00 AM
Check-out: 5:00 PM
Break time: 1 hour 0 minutes
Net worked: 7 hours 0 minutes

/status

Check your current check-in status.

/status

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

Cooldown: 5 seconds

Displays:

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

If checked in:

⏱️ Currently checked in
Server: Work Server
Started: 9:00 AM (3 hours ago)
Duration: 3 hours 0 minutes
Break: 30 minutes (active)
Auto-close in: 9 hours

If not checked in:

ℹ️ Not checked in
You don't have an active work session.

Use /checkin to start tracking time.

/stats

View your work statistics for different time periods.

/stats [range] [user]

Parameters:

  • range (optional): Time period - today, week, month, or all-time (default: today)
  • user (optional, admin only): View another user's statistics

Cooldown: 10 seconds

Shows:

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

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

Examples:

# Today's stats
/stats range:today

# Weekly stats
/stats range:week

# View another user (admin only)
/stats range:today user:@username

See Statistics for detailed documentation.

/history

View your recent work sessions.

/history [limit]

Parameters:

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

Cooldown: 10 seconds

Shows: For each session:

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

Example:

/history limit:20

/leaderboard

View server rankings based on worked time.

/leaderboard [range]

Parameters:

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

Cooldown: 10 seconds

Shows:

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

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

Examples:

# Weekly leaderboard
/leaderboard range:week

# All-time leaderboard
/leaderboard range:all-time

See Leaderboards for detailed documentation.

/break

Manage breaks during your work session.

/break <start|end|status>

Subcommands:

/break start

Start a break. Your work timer pauses.

Example:

☕ Break started at 12:00 PM
Your work timer is paused.

Use /break end to resume work.

/break end

End your current break. Work timer resumes.

Example:

✅ Break ended at 1:00 PM
Duration: 1 hour 0 minutes

Your work timer has resumed.

/break status

Check if you're currently on break.

Example:

☕ Currently on break
Started: 12:00 PM (30 minutes ago)
Duration: 30 minutes

Use /break end to resume work.

Cooldown: 5 seconds

Notes:

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

See Break Tracking for detailed documentation.

/public

Opt-in or opt-out of public leaderboards.

/public [visibility]

Parameters:

  • visibility (optional): on or off
    • If not provided, shows your current visibility status
    • on - Appear on public leaderboards
    • off - Make yourself private

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

Cooldown: 30 seconds

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

Examples:

# Check current status
/public

# Opt in to leaderboards
/public visibility:on

# Opt out (go private)
/public visibility:off

GDPR & Privacy Commands

/data-export

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

/data-export

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

Cooldown: 24 hours

Includes:

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

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

See Data Export for detailed documentation.

/data-delete

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

/data-delete <current-server|all-servers>

Subcommands:

/data-delete current-server

Delete your data from THIS server only.

/data-delete all-servers

Delete your data from ALL servers permanently.

Cooldown: None (one-time action)

Confirmation: Requires button confirmation to prevent accidental deletion

Deletes:

  • User profile
  • All work sessions
  • All break sessions
  • All statistics
  • All preferences

Notes:

  • 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:

# Delete from current server
/data-delete current-server

# Delete from all servers
/data-delete all-servers

See Data Deletion for detailed documentation.

/privacy

View Clocky's privacy policy.

/privacy

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

Cooldown: None

/terms

View Clocky's terms of service.

/terms

Description: Displays a link to the complete terms of service.

Cooldown: 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

Premium benefits: Premium, Pro, and Lifetime tiers get 50% faster cooldowns for most commands.

Quick Reference

Basic Workflow

/checkin              # Start working
/status               # Check current status
/break start          # Take a break
/break end            # Resume working
/checkout             # End your day
/stats range:today    # View your stats

Statistics & History

/stats range:today    # Today's stats
/stats range:week     # This week
/stats range:month    # This month
/history limit:10     # Last 10 sessions
/leaderboard          # Server rankings

Privacy & Data

/public visibility:on  # Opt in to leaderboards
/public visibility:off # Go private
/data-export          # Export your data
/data-delete current-server  # Delete from this server

Admin Commands

Premium Commands

Quick Start Guide

All Commands (Detailed)

Was this page helpful?