Commands Reference

Complete reference for all Timekeeper commands. All commands use Discord's slash command system for ease of use.

Overview

Timekeeper V2 provides two categories of commands:

  • User Commands - Available to all users (unless permissions are restricted)
  • Admin Commands - Require administrator permissions or specific roles

User Commands

These commands are the core of Timekeeper's functionality, available to all users by default.

/clockin
User
Start tracking time for a specific category. Automatically assigns the category role if configured.
category (required) - The category to track time for 
/clockin category:Development
/clockout
User
Stop tracking time and save your session. Removes the category role and calculates total time.
/clockout
/status
User
View your current status, total time tracked, and session information. Can also check other users' status.
user (optional) - View another user's status 
/status
/status user:@John
/dashboard
User
Open an interactive dashboard with buttons for clock in/out, live stats, and category selection.
personal (optional) - Make the dashboard private (default: false) 
/dashboard
/dashboard personal:true
/leaderboard
User
View server leaderboards and rankings. Filter by category and time period.
category (optional) - Filter by specific category
timeframe (optional) - all, week, month (default: all) 
/leaderboard
/leaderboard category:Development timeframe:week
/insights
Premium
View ML-powered productivity insights, recommendations, and trend analysis.
user (optional) - View insights for another user 
/insights
/insights user:@John
/export
User
Export your time tracking data in various formats for analysis or record keeping.
format (required) - csv, pdf, or docx
user (optional) - Export for another user (admin only)
from (optional) - Start date (YYYY-MM-DD)
to (optional) - End date (YYYY-MM-DD) 
/export format:csv
/export format:pdf user:@John
/export format:docx from:2025-01-01 to:2025-01-31

Admin Commands

These commands require administrator permissions or specific management roles configured in your server.

/admin categories
Admin
Manage time tracking categories for your server. Add, remove, edit, or list categories.
action (required) - list, add, remove, edit
name (optional) - Category name
description (optional) - Category description
color (optional) - Hex color code (#RRGGBB)
productivity_weight (optional) - Scoring multiplier (0.0-2.0) 
/admin categories action:list
/admin categories action:add name:Development description:"Dev work" color:#6366f1
/admin categories action:remove name:OldCategory
/admin categories action:edit name:Development productivity_weight:1.5
/admin system
Admin
View system health metrics, cache performance, circuit breaker status, and bot statistics.
/admin system
/config
Admin
Configure server settings for Timekeeper including timezone, work hours, and features.
setting (required) - timezone, work_hours, analytics, permissions
value (required) - New value for the setting 
/config setting:timezone value:America/New_York
/config setting:analytics value:enabled
/config setting:work_hours value:09:00-17:00
/forceclockout
Admin
Force clock out a user. Useful when users forget to clock out or for administrative corrections.
user (required) - User to clock out 
/forceclockout user:@John
/activitylog
Admin
Configure activity logging for audit trails. Logs all clock in/out events to a channel.
enabled (required) - true or false
channel (optional) - Channel for logs 
/activitylog enabled:true channel:#audit-logs
/activitylog enabled:false