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

# Inbox

> Triage agent-proposed documentation with a fast, keyboard-driven review queue.

The Inbox is where agent-proposed documentation waits for your decision. When a tracked commit changes something your docs describe, or an agent sweep finds an undocumented area, the resulting drafts land here — you accept or reject each one, then ship everything you accepted in a single step.

You stay in control: nothing an agent proposes reaches your docs without a human decision.

## Layout

The Inbox has three panes:

<CardGroup cols={3}>
  <Card title="Requests" icon="layers">
    One request per commit or agent sweep — "Commit `abc1234`" or "N suggested docs" — each showing its origin and review progress.
  </Card>

  <Card title="Files" icon="files">
    Every proposed doc in the request, with Accepted/Rejected tags, per-row accept/reject buttons, and batch actions.
  </Card>

  <Card title="Detail" icon="file-search">
    The selected proposal — why it exists, and exactly what it changes.
  </Card>
</CardGroup>

Requests come from two origins, and each row says which: **User commit** — a commit on a tracked branch touched something your docs describe — or **Agent sweep** — the [Coverage Auditor](/agents/coverage-auditor) proposed docs with no commit involved.

## Understanding a proposal

The detail pane leads with a **provenance card** that explains why the doc was proposed — for example, "Commit `abc1234` changed **Flow** `Discount_Approval`, which this doc describes" or "The agent's coverage sweep found **ApexClass** `InvoiceService` undocumented". You never have to guess where a draft came from. New docs are tagged **New document**; updates are marked **Required update** or **Suggested**.

Below it, a **Preview/Changes** toggle shows the proposal two ways:

* **Preview** — rendered markdown, best for brand-new docs.
* **Changes** — a diff against the current doc, best for updates.

Diagrams render live in the preview, so a proposed Mermaid or Excalidraw change is judged as a picture, not a wall of syntax. See [Diagrams](/guides/diagrams).

## Triage

Work through a request with the keyboard:

| Key                         | Action               |
| --------------------------- | -------------------- |
| <kbd>J</kbd> / <kbd>K</kbd> | Next / previous file |
| <kbd>A</kbd>                | Accept               |
| <kbd>X</kbd>                | Reject               |

Accepting or rejecting **auto-advances** to the next undecided file, so a batch of ten proposals takes seconds. Every decision offers **Undo**, so a slip of the finger costs nothing.

Batch actions sit at the bottom of the file list when you want to move faster:

* **Accept all** / **Reject all**
* **Create PR with the accepted files** — open the pull request immediately
* **Open as a change request instead** — polish the drafts in LivingContext first

## Shipping accepted files

When every file has a decision, the reading pane becomes a summary — **Queue clear** — with a **Ship accepted files** action. It rolls all accepted docs into one unit for your workflow:

* **A pull request** in your docs repository, if you review in GitHub or GitLab.
* **A [change request](/guides/editing-and-change-requests)**, if you want to refine the drafts in LivingContext before merging.

Shipped requests link straight to the resulting PR or CR, so you can follow the work to the finish.

<Tip>
  Shipping as a CR is the right choice when a draft is close but not perfect — you can refine it with the doc agent before it merges, instead of rejecting it outright.
</Tip>

## Where proposals come from

* **Tracked commits** — branches you track are swept automatically, and each relevant commit produces a request. See [Commits](/guides/commits).
* **Agent sweeps** — the [Coverage Auditor](/agents/coverage-auditor) proposes brand-new docs for undocumented areas of your Salesforce org.
* **Drifted API specs** — when your org's API surface changes, updated OpenAPI specs are proposed rather than overwritten. See [API reference](/guides/api-reference).

<Note>
  The Inbox is the single front door for agent output. If an agent generated it, you'll find it — and decide on it — here. An empty Inbox greets you with **Inbox zero** and pointers to review a commit or head back Home.
</Note>
