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, orall-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, orall-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):
onoroff- If not provided, shows your current visibility status
on- Appear on public leaderboardsoff- 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:onto 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:
| Command | Cooldown | Reason |
|---|---|---|
/checkin, /checkout, /status, /break | 5 seconds | Prevent spam |
/stats, /leaderboard, /history | 10 seconds | Database queries |
/public | 30 seconds | Prevent toggle spam |
/data-export | 24 hours | GDPR compliance, prevent abuse |
| Admin commands | 5-10 seconds | Moderate usage |
Premium benefits: Premium, Pro, and Lifetime tiers get 50% faster cooldowns for most commands.
Rate limits
In addition to per-command cooldowns, guild-level rate limits apply:
| Tier | Commands per minute |
|---|---|
| Free | 60 |
| Premium | 120 |
| Pro | 180 |
| Lifetime | 300 |
Administrators with "Manage Server" permission bypass rate limits.
Need help with a command?
- Check the Quick Start Guide for common workflows
- Visit Troubleshooting for error messages
- See command-specific guides:
- Join our Support Server for live help