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

# Dispatches

> Generate and preview markdown summaries of recent agent work

Dispatches generates a markdown summary of recent agent work across one or more of your repositories — useful for status updates, weekly recaps, and tailored briefs for non-technical stakeholders.

<Note>
  Dispatches is feature-flagged behind `dispatches-web` (frontend) and `dispatches-api` (backend). You'll only see it in the entire.io app sidebar if both flags are enabled for your account.
</Note>

## Open Dispatches

Dispatches lives at `/dispatches/new` in the Entire web app.

* Open it from the sidebar
* Open it from the command palette
* Use the `g d` shortcut

## Configure scope

Choose the repositories you want summarized.

* Select up to **5 repositories** per dispatch
* If you select exactly **1 repository**, a branch picker appears — pick up to 5 branches
* If you select more than 1 repository, branch selection is hidden and the dispatch uses each repo's default branch

Pick a time window:

* `1d`, `7d`, `14d`, or `30d`

<Tip>
  Use a single repository plus specific branches for a focused project update. Use multiple repositories for a broader team summary.
</Tip>

## Choose a voice

Three voices shape the tone of the generated text:

* **`neutral`** — straightforward product-update prose
* **`marvin`** — drier, more sardonic
* **`custom`** — your own framing or audience guidance, up to 1000 characters

If you choose `custom`, enter the framing in the text box.

## Generate a dispatch

Click **Generate dispatch** to send your scope, window, and voice to the dispatch generation API.

Entire returns markdown and renders it inline in the preview pane. The preview also summarizes:

* Repositories covered
* Branches covered
* The normalized date window

The underlying response includes structured metadata about totals, warnings, and grouped repository sections, but the web UI focuses on the rendered markdown.

## Limits and caveats

* **Rate limit** — 1 dispatch per minute per user
* **Saving** — dispatches aren't persisted; the preview is in-memory until you copy or refresh
* **Custom voice** — capped at 1000 characters
* **Branches** — branch selection is only available in single-repository mode

## Example workflows

* **Single-repo focused recap** — one repo + its main branches + 7d window + `neutral` voice for a weekly update
* **Multi-repo team overview** — 3–5 repos + 14d window for a broader team retrospective
* **Custom audience brief** — `custom` voice with framing like *"Audience: product team. Focus on user-visible changes only."*

## Continue with

<CardGroup cols={2}>
  <Card title="Overview" icon="book" href="/web/overview">
    Refresh on what entire.io does and how dispatches fits in.
  </Card>

  <Card title="Inspect a Session" icon="message" href="/web/inspect-session">
    Drill into the sessions and transcripts that dispatches summarize.
  </Card>
</CardGroup>