// RAVEN Development · Hour Logging
TimeKeeper

TimeKeeper is RAVEN's hour tracking and reporting bot for the whole community. Members can clock in and out of projects directly from Discord, view their personal stats, and generate shareable web reports. Leaderboards keep everyone accountable, and an AI-powered query system lets you ask questions about hours in plain English.

Hour Tracking Reporting Leaderboards AI Queries
General
/ping Coming Soon

Checks the bot's latency and confirms TimeKeeper is online and responding.

UsageFull documentation coming soon
Example
/help Coming Soon

Displays a quick-reference list of all available TimeKeeper commands with brief descriptions.

UsageFull documentation coming soon
Example
/tutorial Coming Soon

Walks you through how TimeKeeper works — from clocking in for the first time to generating your first report.

UsageFull documentation coming soon
Example
Time Tracking
/clock-in Coming Soon

Starts a new time entry for your account. You can optionally specify a project or task label. TimeKeeper will record the exact start time and keep the session open until you clock out.

UsageFull documentation coming soon
Example
/clock-out Coming Soon

Closes your active time entry and logs the total duration. You'll see a summary of the session that was just completed, including hours worked.

UsageFull documentation coming soon
Example
/me Coming Soon

Displays your personal time tracking summary — total hours logged, current session status, recent activity, and a breakdown by project if applicable.

UsageFull documentation coming soon
Example
Stats & Reports
/leaderboard Coming Soon

Shows the server-wide leaderboard ranking all staff members by total hours logged within a given time period. Optionally filter by week, month, or all time.

UsageFull documentation coming soon
Example
/statistics Coming Soon

Provides an aggregate view of hours logged across the entire server — including total hours, active members, average session length, and trends over time.

UsageFull documentation coming soon
Example
/report Coming Soon

Generates a shareable web report of logged hours and returns a link valid for 30 days. Optionally filter by user, project, and time period (today, this week, last week, this month, and more). The report includes a full session breakdown, total hours, project and user breakdowns, and per-day statistics — all viewable in a browser without logging in.

UsageFull documentation coming soon
Example
AI & Tools
/ask Coming Soon

Ask TimeKeeper a natural language question about hours data — such as "who worked the most last week?" or "how many hours did the team log in March?" The AI will query the database and respond with the answer.

UsageFull documentation coming soon
Example
/modify Coming Soon

Allows administrators to edit or delete existing time entries — useful for correcting missed clock-outs or erroneous sessions. Requires appropriate permissions.

UsageFull documentation coming soon
Example