> For the complete documentation index, see [llms.txt](https://docs.timecord.dev/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.timecord.dev/docs/guide/commands.md). # Commands ## Commands Every command is a Discord slash command. Type `/` in any channel to see them, with inline descriptions in your server language (English or German). {% hint style="info" %} Commands marked **⭐ Premium** require an active TimeCord subscription for that server. Some commands are only partly premium; that is noted per command. {% endhint %} **Who can use what** * **Everyone** can use the member commands below. * **Admin commands** require either the Discord `Administrator` permission or one of the management roles you set as *access roles* in the dashboard. * Every command can be individually enabled, disabled, or restricted to admins under **Dashboard → Settings → Commands**. *** ### Member commands #### `/help` Shows links to this documentation and to our support server. #### `/info` `[user]` Shows a member profile: * Hired since, and current duty status (clocked in since, or last time clocked out) * Job and rank, if configured (see Ranks) * Number of **active** warnings * Daily, weekly, monthly and all-time hours Run it on yourself, or pass a `user` to view someone else. #### `/leaderboard` `` Ranks members by tracked hours. `timeframe` is one of `alltime`, `monthly`, `weekly`, `daily`. The list is **paginated** (10 per page) with ◀ / ▶ buttons, and it respects the server timezone and week start (see [Statistics & Time](/docs/guide/statistics-and-time.md)). #### `/overview` Lists everyone who is currently clocked in and how long they have been on duty. #### `/timerequest` ` [proof-link] [proof-attachment]` ⭐ Premium Lets a member request a time change instead of an admin doing it manually. * `action` - `give` (request time added) or `remove` (request time removed) * `minutes` - how many minutes * `reason` - why * `proof-link` / `proof-attachment` - optional evidence (a link and/or an image/video) The request is posted to your access-role staff with **Approve** and **Reject** buttons. On approval the time is applied automatically and the member is notified. #### `/break` `` Pause and resume your own session without clocking out. `action` is `pause` or `resume`. Break time is **excluded** from your tracked hours, and clocking out while paused is handled correctly. Use it for lunch or an errand so the time in between does not count. #### `/streak` Shows your **current** and **longest** consecutive-day streak, plus the milestones you have earned (for example 100 hours tracked, or a 7-day streak). See [Statistics & Time](/docs/guide/statistics-and-time.md#streaks-and-milestones). #### `/leave` ` ...` Request time off. `request` opens a request with a start date, end date and reason; `list` shows your requests. Your request is posted to the access-role staff with **Approve** and **Deny** buttons. An approved leave that covers the current day excludes you from quota and shift no-show reports, so being off does not count against you. #### `/stats` `[user]` ⭐ Premium Posts a bar chart image of the last 14 days of daily hours, plus your totals. Run it on yourself or pass a `user`. *** ### Admin commands #### `/employee` ` ` Manage a single employee. | Action | What it does | | --------- | ------------------------------------------------------------------------- | | `hire` | Allows the user to track time. This is the requirement for tracking. | | `dismiss` | Revokes tracking. Their data is kept. | | `stop` | Ends their active session; the user **keeps** the tracked time. | | `cancel` | Ends their active session; the user gets **no** time. | | `delete` | Permanently deletes all of the user's data (asks for confirmation first). | {% hint style="info" %} Hiring and dismissing can also happen automatically: enable auto-hire on join, or set **autoroles** in the dashboard so that gaining/losing a role hires/dismisses the member. {% endhint %} #### `/tracking` `` Manage server-wide tracking. | Action | What it does | | ---------- | --------------------------------------------------------------------------------- | | `generate` | Posts the time-clock message with **Clock in** / **Clock out** buttons. | | `list` | Shows a **paginated** list of every hired employee (on-duty first, 🟢 = on duty). | | `stop` ⭐ | Clocks **everyone** out and gives them their time. | | `cancel` ⭐ | Clocks **everyone** out with **no** time. | `generate` and `list` are free; `stop` and `cancel` are premium. #### `/time` ` ` Manually adjust a user's time. `action` is `add` or `remove`, `amount` is in minutes. #### `/timezone` `` Sets the IANA timezone used to bucket daily / weekly / monthly stats, for example `Europe/Berlin`, `America/New_York`, or `UTC` (the default). See [Statistics & Time](/docs/guide/statistics-and-time.md). #### `/language` `` Sets the bot's language for this server: `de` (German), `en` (English) or `fr` (French). #### `/weekstart` `` ⭐ Premium Sets which weekday a week starts on (Monday through Sunday). This changes how weekly stats are grouped. See [Statistics & Time](/docs/guide/statistics-and-time.md). #### `/cleanup` ⭐ Premium Removes users from the database who are no longer on the server. #### `/role` ` ` ⭐ Premium Bulk operations on everyone who has a given role. | Action | What it does | | -------- | ----------------------------------------------- | | `add` | Hires everyone with the role. | | `remove` | Dismisses everyone with the role. | | `reset` | Resets tracked time for everyone with the role. | #### `/warn` ` ` ⭐ Premium The warning system. | Action | What it does | | -------- | ------------------------------------------------------------------ | | `warn` | Opens a modal to set the reason and duration, then warns the user. | | `delete` | Removes one of the user's active warns. | | `show` | Lists the user's active warnings. | Warnings **expire automatically**: once a warn's duration passes it stops counting and is later cleaned up. See [Statistics & Time](/docs/guide/statistics-and-time.md#warnings). #### `/export` ⭐ Premium Exports a **CSV** of every employee's daily, weekly, monthly and all-time hours, ready for payroll. The export respects your timezone and week start. The file is sent privately to you. #### `/shift` ` ...` ⭐ Premium Schedule shifts and rosters. | Action | What it does | | -------- | -------------------------------------------------------------------------------------- | | `create` | Creates a shift with a name, start, end, and members assigned by role or individually. | | `list` | Lists upcoming shifts. | | `cancel` | Cancels a scheduled shift. | TimeCord sends a reminder about 15 minutes before a shift starts, and after it ends it flags any assignee who never clocked in as a **no-show** in your logs channel. Members on approved leave are not counted as no-shows. #### `/quota` ` ...` ⭐ Premium Set and check hour targets. | Action | What it does | | -------- | --------------------------------------------------------------------------- | | `set` | Sets a weekly and/or monthly hour target per member (0 disables it). | | `report` | Lists members who are below target. Members on approved leave are excluded. | #### `/sanction` ` ...` ⭐ Premium The sanction/penalty system. `issue` records a sanction (with an optional fine), `list` shows a user's sanctions, `pay` marks one as paid, and `remove` deletes one. #### `/payrate` ` ...` ⭐ Premium Set the **hourly pay** for a role. `set` maps a role to a rate, `list` shows the current rates, `remove` deletes one. When a member has several paid roles, the **highest** rate is used. #### `/payroll` ⭐ Premium Produces a **CSV** payroll report: each member's hours times their pay rate, with totals. Uses the rates from `/payrate` and respects your timezone and week start. #### `/promotion` ` ...` ⭐ Premium Auto-promote members by all-time hours. `set` maps an hour threshold to a role, `list` shows the thresholds, `remove` deletes one. An hourly job adds the role once a member reaches the threshold. The hours compared are all-time hours (including archived history). #### `/recap` ` ...` ⭐ Premium Configure a scheduled **weekly recap** post (top trackers and totals for the server). | Action | What it does | | -------------------- | ------------------------------------------ | | `channel` | Sets the channel the recap is posted to. | | `day` | Sets which weekday it posts on. | | `enable` / `disable` | Turns the scheduled recap on or off. | | `preview` | Posts a recap right now so you can see it. | #### `/webhook` ` ...` ⭐ Premium An **outbound** webhook that receives a periodic stats snapshot (hired count, on-duty count) as JSON every 12 hours. `set ` configures and enables it, `disable` turns it off, and `test` sends one immediately. Useful for pushing live status into your own systems. #### `/audit` Flags **suspicious sessions**, such as sessions that ran implausibly long or that are still open after a very long time, so you can review and correct them. Admin only.