Quick Start

Get started with Clocky in 5 minutes. This guide covers the essential commands you need to start tracking your work time effectively.

Basic workflow

The core workflow of Clocky is simple:

  1. Check in when you start working
  2. Check out when you're done
  3. View stats to see your total worked time

That's it! Everything else is optional but helps you track time more accurately.

Your First Session

Let's walk through a complete work session:

Complete work session

/checkin

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

Essential commands

These are the commands you'll use most often:

/checkin - Start tracking time

Use this command when you begin your work session.

/checkin
  • Name
    When to use
    Description
    • Starting your workday
    • Returning from lunch
    • Beginning a focused work session
  • Name
    Notes
    Description
    • You can only be checked in to one server at a time
    • If you're already checked in, you'll get a notification
    • Sessions auto-close after 12 hours (configurable)

/checkout - Stop tracking time

Use this when you finish working or take a long break.

/checkout
  • Name
    When to use
    Description
    • Ending your workday
    • Going to lunch (or use /break start instead)
    • Finishing a work session
  • Name
    Notes
    Description
    • Shows summary with total worked time
    • Must be checked in first
    • Adds time to your statistics automatically

/status - Check current session

See if you're checked in and for how long.

/status
  • Name
    Shows
    Description
    • Whether you're currently checked in
    • Check-in time and duration
    • Current break status (if applicable)
  • Name
    Use cases
    Description
    • Verify you remembered to check in
    • See how long you've been working
    • Quick time check

/stats - View your statistics

See your total worked time over different periods.

/stats range:today
/stats range:week
/stats range:month
/stats range:all-time
  • Name
    Parameters
    Description

    range (optional): today, week, month, or all-time (default: today) user (optional): View another user's public statistics

  • Name
    Shows
    Description
    • Total worked time for the period
    • Number of sessions
    • Average session duration
    • Longest session

Viewing statistics

Statistics help you understand your work patterns and productivity.

Personal Statistics

View your own statistics for different time ranges:

Statistics examples

/stats range:today

# Shows:
📊 Your Statistics (Today)
Total worked: 6 hours 30 minutes
Sessions: 2
Average: 3 hours 15 minutes
Longest: 4 hours

Leaderboards

See how you rank compared to other users in your server:

/leaderboard range:week

Leaderboards are private by default. Only users who opt-in with /public will appear on the leaderboard.

To opt-in to public leaderboards:

/public

Taking breaks

Track breaks separately from your work time.

Starting a break

/break start

This pauses your work session without checking out. Your break time is tracked separately and won't count toward your worked time.

Ending a break

/break end

This resumes your work session where you left off.

Checking break status

/break status

Shows if you're currently on break and for how long.

When to use breaks vs checkout:

  • Use /break for short breaks (lunch, coffee, meetings)
  • Use /checkout when you're completely done working for the day

History and session tracking

View recent sessions

See your recent work sessions:

/history limit:10

Shows your last 10 sessions with start time, end time, and duration.

  • Name
    Parameters
    Description

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

  • Name
    Shows
    Description
    • Session date and time
    • Duration
    • Server name
    • Break time (if applicable)

Next steps

Now that you know the basics, explore more features:

Learn about features

Deep dive: Check-in System

Break Tracking Details

Understanding Statistics

Leaderboards & Privacy

For server admins

Server Configuration

Managing User Sessions

Explore all commands

View All Commands

Common questions

What happens if I forget to check out?

Don't worry! Sessions automatically close after 12 hours (configurable by server admins). Admins can also manually close your session with /admin-close-session.

Can I check in to multiple servers?

No, you can only be checked in to one server at a time. If you try to check in to a second server, you'll be prompted to check out from the first one.

Do breaks count toward my worked time?

No, break time is tracked separately and excluded from your total worked time. This gives you accurate statistics about actual work time.

Can others see my statistics?

By default, your statistics are private. They're only visible to you. You can opt-in to public leaderboards with /public, which makes your total worked time visible to others in the server.

How long is data retained?

Data retention depends on your server's subscription tier:

  • Free: 1 year
  • Premium: 5 years
  • Pro: 10 years
  • Lifetime: Unlimited

You can export or delete your data at any time. See Data Export and Data Deletion.

Tips for success

Pro tips for accurate time tracking:

  1. Check in immediately when you start working
  2. Use breaks for lunch and meetings instead of checking out
  3. Check out when done for the day to keep sessions accurate
  4. Review your history weekly with /history to spot patterns
  5. Set goals using statistics to track improvement

Need help?

Was this page helpful?