> ## Documentation Index
> Fetch the complete documentation index at: https://docs.volvox.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Channel Summaries with the /tldr Command

> Use the /tldr Discord command to summarize recent channel messages by count or hours, extracting key topics, decisions, action items, and links with AI.

# TL;DR

The `/tldr` command uses AI to summarize recent channel messages into a structured summary with key topics, decisions, action items, and notable links.

## What it does

* **Instant summaries** — Use `/tldr` to summarize the last 50 messages (configurable)
* **Time-based** — Use `/tldr hours:24` to summarize the last 24 hours
* **AI-powered** — Your selected model extracts key topics, decisions, action items, and links
* **Rich embeds** — Cleanly formatted summaries right in Discord
* **Configurable** — Custom system prompts, cooldowns, and message limits

## Settings location

TL;DR settings are in **Settings -> Community Tools -> TL;DR**.

## TL;DR settings

The **TL;DR** settings tab at `/dashboard/settings/community-tools?tab=tldr` controls whether `/tldr` is enabled, which model summarizes messages, the default and maximum message counts, per-user cooldown, and custom summary instructions.

## How to use

1. Use `/tldr` in any channel to summarize recent messages.
2. Optionally adjust TL;DR in **Settings -> Community Tools -> TL;DR**.
3. Optionally specify `count` (1–200 messages) or `hours` (1–168 hours).
4. The AI returns a structured summary with topics, decisions, actions, and links.

## Example

Using `/tldr hours:2` in a busy channel:

> **📋 TL;DR Summary** — Summarized **87** messages in #general
>
> 🗝️ **Key Topics**: Feature roadmap discussion, community event planning, bug triage
> ✅ **Decisions Made**: Moving to weekly releases, adopting new CI pipeline
> 📌 **Action Items**: @dev team: update docs by Friday, @mods: set up event channel
> 🔗 **Notable Links**: design mockup, CI migration guide

## Configuration

| Setting            | Description                                 | Default                 |
| ------------------ | ------------------------------------------- | ----------------------- |
| Enabled            | Toggle the `/tldr` command                  | On                      |
| Model              | Supported provider/model used for summaries | `z-ai:glm-5.2`          |
| Default messages   | Messages to summarize                       | 50                      |
| Max messages       | Hard cap on message count                   | 200                     |
| Cooldown (seconds) | Per-user cooldown per server                | 300                     |
| System prompt      | Custom AI instructions                      | Built-in summary prompt |