Statistics & History

View detailed statistics about your work time and review your session history.

Overview

Clocky automatically tracks all your work sessions and calculates statistics to help you understand your work patterns and productivity.

What statistics track

Privacy

Your statistics are private by default. Only you can see your detailed stats unless:

• You opt-in to public leaderboards with /public
• A server admin views your stats with /stats user:@you

Viewing statistics

Basic stats command

View your statistics for today:

/stats

Response:

📊 Your Statistics (Today)

Total worked: 6 hours 30 minutes
Sessions: 2
Average: 3 hours 15 minutes
Longest: 4 hours

─────────────────────
✨ Keep up the great work!

View different time ranges

/stats range:week
/stats range:month
/stats range:all-time

View another user's stats (Admin only)

Server administrators can view any user's statistics:

/stats user:@username range:today

Time ranges

Statistics can be viewed for different time periods:

Today

/stats range:today

Shows statistics from midnight to now in your local timezone.

Example:

📊 Your Statistics (Today)

Total worked: 6 hours 30 minutes
Sessions: 2
Average: 3 hours 15 minutes
Longest: 4 hours

This Week

/stats range:week

Shows statistics from the start of the current week (Monday) to now.

Example:

📊 Your Statistics (This Week)

Total worked: 32 hours 15 minutes
Sessions: 10
Average: 3 hours 13 minutes
Longest: 5 hours 30 minutes

📅 Breakdown by day:
Monday:    6h 30m
Tuesday:   7h 15m
Wednesday: 6h 45m
Thursday:  7h 0m
Friday:    4h 45m

This Month

/stats range:month

Shows statistics from the 1st of the current month to now.

Example:

📊 Your Statistics (This Month)

Total worked: 140 hours 30 minutes
Sessions: 45
Average: 3 hours 7 minutes
Longest: 7 hours 15 minutes

📈 Weekly totals:
Week 1: 35h 15m
Week 2: 38h 30m
Week 3: 36h 45m
Week 4: 30h 0m

All Time

/stats range:all-time

Shows your complete statistics since you first used Clocky.

Example:

📊 Your Statistics (All Time)

Total worked: 248 hours 45 minutes
Sessions: 89
Average: 2 hours 47 minutes
Longest: 8 hours 30 minutes

🎯 Milestones:
First session: Jan 15, 2025
Total days active: 34

Session history

View recent sessions

See a list of your recent work sessions:

/history limit:10

Response:

📋 Your Recent Sessions (Last 10)

1. Today, 9:00 AM - 5:00 PM
   Duration: 8h 0m | Break: 1h 0m | Worked: 7h 0m
   Server: Work Server

2. Yesterday, 10:00 AM - 6:30 PM
   Duration: 8h 30m | Break: 1h 15m | Worked: 7h 15m
   Server: Work Server

3. Dec 10, 2:00 PM - 4:30 PM
   Duration: 2h 30m | Break: 0m | Worked: 2h 30m
   Server: Side Project

... (7 more sessions)

History command options

/history limit:5   # Show last 5 sessions
/history limit:25  # Show last 25 sessions
/history limit:50  # Show last 50 sessions (maximum)

What history shows

Each session in your history displays:

• Date and time (check-in to check-out)
• Total duration
• Break time
• Net worked time
• Server name where session occurred

Understanding metrics

Total worked time

Definition: Sum of all worked time (excluding breaks) for the selected period.

Calculation:

For each session:
  Worked Time = Check-out Time - Check-in Time - Break Time

Total Worked Time = Sum of all Worked Times

Example:

• Session 1: 8h - 1h break = 7h worked
• Session 2: 4h - 0h break = 4h worked
• Total: 11h worked

Number of sessions

Definition: How many times you completed a check-in/check-out cycle.

Notes:

• Only completed sessions count (checked out, not still active)
• Auto-closed sessions count as completed
• One check-in + one check-out = one session

Average session duration

Definition: Mean length of your work sessions.

Calculation:

Average = Total Worked Time / Number of Sessions

Example:

• Total worked: 21 hours
• Sessions: 7
• Average: 3 hours

Use case: Understand your typical work session length.

Longest session

Definition: Your longest single work session (worked time, excluding breaks).

Example:

Longest session: 7 hours 30 minutes
Date: Dec 10, 2025
Server: Work Server

Use case: Track your focus and endurance over time.

Statistics by server

Server isolation

Statistics are tracked per Discord server. Your stats in Server A are completely separate from Server B.

Example:

Work Server:
  Total worked: 100 hours
  Sessions: 40

Side Project Server:
  Total worked: 25 hours
  Sessions: 15

Combined view

The /stats command only shows statistics for the current server where you run the command.

To see stats from another server, go to that server and run /stats there.

Data retention

Statistics are based on session data, which is retained based on your server's subscription tier:

What happens when data expires

When sessions expire:

• They're removed from your history
• They no longer count in your all-time statistics
• Week/month stats are unaffected if within retention period

Exporting your statistics

Data export

Export all your raw session data:

/data-export

You'll receive a JSON file via DM containing:

• All work sessions
• All break sessions
• Timestamps
• Durations
• Server information

Use cases:

• Backup your data
• Import into spreadsheets
• Create custom reports
• GDPR data portability

See Data Export Guide for details.

Statistics for admins

Viewing user statistics

Server administrators with "Manage Server" permission can view any user's statistics:

/stats user:@username range:today

This shows the same information the user would see in their own stats.

Use cases for admin stats

• Monitor team productivity
• Verify reported hours
• Identify inactive users
• Troubleshoot time tracking issues

Privacy considerations

Admins can see:

• ✅ Total worked time
• ✅ Number of sessions
• ✅ Average and longest sessions

Admins cannot see (without additional commands):

• ❌ Exact check-in/check-out times
• ❌ Individual session details
• ❌ Break duration details

For detailed session information, admins need to use /history or session management commands.

Comparing your statistics

Personal trends

Compare your stats across different time ranges:

/stats range:today    # Today's performance
/stats range:week     # Weekly average
/stats range:month    # Monthly trends
/stats range:all-time # Overall baseline

Leaderboards

See how you compare to others (opt-in only):

/leaderboard range:week

Learn more: Leaderboards

Troubleshooting

Stats showing zero

Problem: /stats shows no worked time.

Possible causes:

1. You haven't checked in/out yet in this server
2. Data has expired (check retention period)
3. You're viewing the wrong time range
4. Sessions are still active (not checked out)

Solution: Try /stats range:all-time to see if you have any recorded time.

Stats seem incorrect

Problem: Worked time doesn't match expectations.

Check:

1. Break time excluded? - Breaks don't count toward worked time
2. Auto-close applied? - Sessions may have been auto-closed
3. Right server? - Stats are per-server
4. View history: - Run /history to see actual sessions

Missing sessions in history

Problem: Some past sessions don't appear in history.

Causes:

1. Data retention limit - Sessions older than retention period are deleted
2. History limit - Default shows only 10 sessions (use limit:50 for more)
3. Different server - Sessions are per-server

Tips for using statistics

Goal setting

Use your statistics to set realistic goals:

Example:

• Current average: 3 hours per session
• Goal: Increase to 4 hours (better focus)
• Track progress with weekly stats

Related features

• Check-in System: How sessions are tracked
• Break Tracking: How breaks affect statistics
• Leaderboards: Compare with others
• Data Export: Export your raw data

Next steps